{"componentChunkName":"component---src-templates-docs-js","path":"/whatsapp/messaging/http","result":{"data":{"site":{"siteMetadata":{"title":"broadcaster","docsLocation":"https://github.com","docsLocationType":"github","editable":false}},"mdx":{"fields":{"id":"03f69984-270c-56fa-871e-9fcc827e4db5","title":"HTTP connection","slug":"/whatsapp/messaging/http"},"body":"function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }\n\nfunction _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }\n\nfunction _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }\n\n/* @jsx mdx */\nvar _frontmatter = {\n  \"title\": \"HTTP connection\",\n  \"order\": 1\n};\nvar layoutProps = {\n  _frontmatter: _frontmatter\n};\nvar MDXLayout = \"wrapper\";\nreturn function MDXContent(_ref) {\n  var components = _ref.components,\n      props = _objectWithoutProperties(_ref, [\"components\"]);\n\n  return mdx(MDXLayout, _extends({}, layoutProps, props, {\n    components: components,\n    mdxType: \"MDXLayout\"\n  }), mdx(\"p\", null, \"All non-template, template and interactive messages are sent with this endpoint. This page describes, once, the request, the headers, the common body fields and the response. The fields specific to each message type are on its own page.\"), mdx(\"section\", {\n    \"id\": \"request\"\n  }, mdx(\"h2\", {\n    parentName: \"section\"\n  }, \"Request\"), mdx(\"table\", {\n    parentName: \"section\"\n  }, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }))), mdx(\"tbody\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"URL\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"https://{{url}}/whatsapp-bsp-api-endpoint-ws/services/v1/messaging\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Method\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"POST\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Type\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"application/json\"))))), mdx(\"section\", {\n    \"id\": \"headers\"\n  }, mdx(\"h2\", {\n    parentName: \"section\"\n  }, \"Headers\"), mdx(\"table\", {\n    parentName: \"section\"\n  }, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Name\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Description\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Type\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Requirements\"))), mdx(\"tbody\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Content-Type\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"application/json\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Required\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Authorization\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Messaging token in the format \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"Bearer {token}\"), \" (with one space). See \", mdx(\"a\", {\n    href: \"/whatsapp/authentication_token\"\n  }, \"Generate authentication token\"), \".\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Required\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Msg-Priority\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Priority of the message in the sending queue. Possible values: \", mdx(\"ul\", null, mdx(\"li\", null, \"LOW\"), mdx(\"li\", null, \"MEDIUM\"), mdx(\"li\", null, \"HIGH\")), \" Any other value is treated as MEDIUM.\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"ul\", null, mdx(\"li\", null, \"Optional.\"), mdx(\"li\", null, \"Default: MEDIUM.\"))))))), mdx(\"section\", {\n    \"id\": \"commonfields\"\n  }, mdx(\"h2\", {\n    parentName: \"section\"\n  }, \"Common fields\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, \"Every message includes these fields in the request body:\"), mdx(\"table\", {\n    parentName: \"section\"\n  }, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Name\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Description\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Type\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Requirements\"))), mdx(\"tbody\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"from\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Phone number (with country code) the message is sent from.\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Required.\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"to\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Phone number (with country code) of the customer receiving the message. 7 to 20 characters; \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"+\"), \" is only allowed as the first character. Hyphens (-), parentheses ((,)), and spaces are also allowed. You can also use the user's \", mdx(\"a\", {\n    href: \"/whatsapp/receive_notifications#h-usernamesandbsuid\"\n  }, \"BSUID\"), \", for example, US.13491208655302741918. The phone format check does not apply when \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"recipient_type\"), \" is \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"group\"), \".\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Required.\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"type\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Message type. Possible values: \", mdx(\"ul\", null, mdx(\"li\", null, \"text\"), mdx(\"li\", null, \"image\"), mdx(\"li\", null, \"audio\"), mdx(\"li\", null, \"video\"), mdx(\"li\", null, \"document\"), mdx(\"li\", null, \"sticker\"), mdx(\"li\", null, \"location\"), mdx(\"li\", null, \"contacts\"), mdx(\"li\", null, \"reaction\"), mdx(\"li\", null, \"template\"), mdx(\"li\", null, \"interactive\"), mdx(\"li\", null, \"pin (only in \", mdx(\"a\", {\n    href: \"/whatsapp/administration/groups\"\n  }, \"Groups\"), \")\")), \" Each message type states the value it uses.\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Required.\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"recipient_type\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Recipient type. Possible values: \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"individual\"), \" or \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"group\"), \". See the \", mdx(\"a\", {\n    href: \"/whatsapp/administration/groups\"\n  }, \"Groups\"), \" section for details.\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, mdx(\"ul\", null, mdx(\"li\", null, \"Optional.\"), mdx(\"li\", null, \"Default: \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"individual\"), \".\"))))))), mdx(\"section\", {\n    \"id\": \"commonfields--marketingmessageslite(mmlite)fields\"\n  }, mdx(\"h3\", {\n    parentName: \"section\"\n  }, \"Marketing Messages Lite (MM Lite) fields\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, \"These fields apply only to messages sent from WABAs with \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Marketing Messages Lite (MM Lite)\"), \" enabled. They are forwarded to Meta.\"), mdx(\"table\", {\n    parentName: \"section\"\n  }, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Name\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Description\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Type\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Requirements\"))), mdx(\"tbody\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"category\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Message category, for example \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"UTILITY\"), \" or \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"MARKETING\"), \". Required for \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"ttl_seconds\"), \" and \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"direct_send_config\"), \" to take effect.\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Optional.\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"ttl_seconds\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Message time to live in seconds. Only applied when \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"category\"), \" is set. Validated against the allowed minimum and maximum.\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Integer\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Optional.\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"direct_send_config.template_name\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Template name used for MM Lite direct send. Only applied when \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"category\"), \" is set.\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Optional.\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"bid_spec.per_message_bid_multiplier\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Per-message bid multiplier for MM Lite marketing messages.\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Number\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Optional.\"))))), mdx(\"section\", {\n    \"id\": \"response\"\n  }, mdx(\"h2\", {\n    parentName: \"section\"\n  }, \"Response\"), mdx(\"blockquote\", {\n    parentName: \"section\"\n  }, mdx(\"p\", {\n    parentName: \"blockquote\"\n  }, \"HTTP status codes: \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"200\"), \" on success, \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"400\"), \" on validation errors, \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"401\"), \" on authentication errors, \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"500\"), \" on internal errors.\")), mdx(\"table\", {\n    parentName: \"section\"\n  }, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Name\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Description\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Type\"))), mdx(\"tbody\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"id\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"ID of the sent message.\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"code\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Response code if an error occurs. For details, see \", mdx(\"a\", {\n    href: \"/whatsapp/error_codes\"\n  }, \"Error codes\"), \".\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Number\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"detail\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Message describing the response code.\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\"))))), mdx(\"section\", {\n    \"id\": \"response--successfulresponseexample\"\n  }, mdx(\"h3\", {\n    parentName: \"section\"\n  }, \"Successful response example\"), mdx(\"pre\", {\n    parentName: \"section\"\n  }, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-json\"\n  }, \"[\\n    {\\n        \\\"id\\\": \\\"gBGHUhVUByKUHwIJCSIVo3YWvs8i\\\"\\n    }\\n]\\n\"))), mdx(\"section\", {\n    \"id\": \"response--errorresponseexample\"\n  }, mdx(\"h3\", {\n    parentName: \"section\"\n  }, \"Error response example\"), mdx(\"pre\", {\n    parentName: \"section\"\n  }, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-json\"\n  }, \"{\\n    \\\"code\\\": 3009,\\n    \\\"detail\\\": \\\"JWT token expired\\\"\\n}\\n\"))));\n}\n;\nMDXContent.isMDXComponent = true;","tableOfContents":{"items":[{"url":"#request","title":"Request"},{"url":"#headers","title":"Headers"},{"url":"#common-fields","title":"Common fields","items":[{"url":"#marketing-messages-lite-mm-lite-fields","title":"Marketing Messages Lite (MM Lite) fields"}]},{"url":"#response","title":"Response","items":[{"url":"#successful-response-example","title":"Successful response example"},{"url":"#error-response-example","title":"Error response example"}]}]},"timeToRead":1,"parent":{"__typename":"File","relativePath":"whatsapp/messaging/http.md","fields":{"gitLogLatestAuthorName":"Irais Aguirre","gitLogLatestAuthorEmail":"irais.aguirre@conceptomovil.com","gitLogLatestDate":"6 hours ago"}},"frontmatter":{"metaTitle":null,"showMetadata":null,"editable":null,"showPreviousNext":null,"showToc":null}},"gitBranch":{"name":"20211019-2FACTOR_AUTH"},"gitCommit":{"hash":"9713e1925aeb8cad930f91b6bf05d0b5937b2bb5","date":"2026-11-13 06:39"}},"pageContext":{"id":"03f69984-270c-56fa-871e-9fcc827e4db5"}},"staticQueryHashes":["12478684","12478684","2882937274","2882937274","353167761","353167761"]}