{"componentChunkName":"component---src-templates-docs-js","path":"/whatsapp/messaging/quickstart","result":{"data":{"site":{"siteMetadata":{"title":"broadcaster","docsLocation":"https://github.com","docsLocationType":"github","editable":false}},"mdx":{"fields":{"id":"c0c34082-e2fb-52fe-a000-a747c171aa94","title":"Quickstart","slug":"/whatsapp/messaging/quickstart","lang":"es"},"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\": \"Quickstart\",\n  \"metaTitle\": \"Quickstart: Envía tu primer mensaje\",\n  \"order\": 0\n};\n\nvar makeShortcode = function makeShortcode(name) {\n  return function MDXDefaultShortcode(props) {\n    console.warn(\"Component \" + name + \" was not imported, exported, or provided by MDXProvider as global scope\");\n    return mdx(\"div\", props);\n  };\n};\n\nvar Info = makeShortcode(\"Info\");\nvar Warning = makeShortcode(\"Warning\");\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, \"Esta gu\\xEDa r\\xE1pida te lleva paso a paso por el env\\xEDo de un mensaje, la lectura de la respuesta de la API y la confirmaci\\xF3n de la entrega mediante un callback del webhook.\"), mdx(\"section\", {\n    \"id\": \"antesdecomenzar\"\n  }, mdx(\"h2\", {\n    parentName: \"section\"\n  }, \"Antes de comenzar\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, \"Aseg\\xFArate de tener todo lo siguiente:\"), mdx(\"ul\", {\n    parentName: \"section\"\n  }, mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"Hosts, credenciales y acceso por IP habilitados por Operaciones. Las peticiones desde IPs que no est\\xE1n en la lista de acceso son rechazadas. Consulta \", mdx(\"a\", {\n    href: \"/whatsapp/description\"\n  }, \"Informaci\\xF3n general\"), \".\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"Un remitente de negocio y una WABA (WhatsApp Business Account) asignados, incluido el phone number ID del remitente.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"Un destinatario de prueba controlado, es decir, un n\\xFAmero de WhatsApp de tu propiedad que haya aceptado (opt-in) recibir mensajes de tu negocio.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"Una plantilla aprobada, o una ventana de servicio abierta con el destinatario de prueba (ver abajo).\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"Un webhook registrado que pueda recibir callbacks de estatus. Sin \\xE9l no puedes confirmar la entrega. Consulta \", mdx(\"a\", {\n    href: \"/whatsapp/receive_notifications/webhook\"\n  }, \"Webhook\"), \".\"))), mdx(\"section\", {\n    \"id\": \"eligeeltipodemensaje\"\n  }, mdx(\"h2\", {\n    parentName: \"section\"\n  }, \"Elige el tipo de mensaje\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, \"El mensaje que puedes enviar depende de si el cliente te escribi\\xF3 recientemente:\"), mdx(\"ul\", {\n    parentName: \"section\"\n  }, mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"El cliente te escribi\\xF3 o te llam\\xF3 en las \\xFAltimas 24 horas\"), \" (la ventana de servicio est\\xE1 abierta): puedes enviar un mensaje libre (mensaje de servicio), como texto, multimedia o contenido interactivo. Consulta \", mdx(\"a\", {\n    href: \"/whatsapp/messaging/without_template\"\n  }, \"Mensajes sin plantilla\"), \".\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"En cualquier otro caso:\"), \" debes enviar una plantilla aprobada. Esto incluye el primer mensaje a un cliente nuevo. Consulta \", mdx(\"a\", {\n    href: \"/whatsapp/messaging/with_template\"\n  }, \"Mensajes con plantilla\"), \" y \", mdx(\"a\", {\n    href: \"/whatsapp/administration/template_management/create\"\n  }, \"Crear plantilla\"), \".\")), mdx(Info, {\n    mdxType: \"Info\"\n  }, mdx(\"p\", {\n    parentName: \"section\"\n  }, \"Si no est\\xE1s seguro de que la ventana est\\xE9 abierta, env\\xEDa una plantilla. Las plantillas son v\\xE1lidas tanto dentro como fuera de la ventana. Un mensaje libre enviado fuera de la ventana falla con el error \", mdx(\"a\", {\n    href: \"/whatsapp/error_codes\"\n  }, \"470\"), \".\"))), mdx(\"section\", {\n    \"id\": \"paso1:envíaelmensaje\"\n  }, mdx(\"h2\", {\n    parentName: \"section\"\n  }, \"Paso 1: Env\\xEDa el mensaje\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, \"Todos los mensajes se env\\xEDan con \", mdx(\"a\", {\n    href: \"/whatsapp/messaging/http\"\n  }, \"POST /v1/messaging\"), \" y el token de mensajer\\xEDa (\", mdx(\"a\", {\n    href: \"/whatsapp/authentication_token\"\n  }, \"c\\xF3mo generarlo\"), \"). Este ejemplo env\\xEDa una plantilla aprobada:\"), mdx(\"pre\", {\n    parentName: \"section\"\n  }, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-bash\"\n  }, \"curl -X POST 'https://{{url}}/whatsapp-bsp-api-endpoint-ws/services/v1/messaging' \\\\\\n-H 'Authorization: Bearer {{wa-msg-api-token}}' \\\\\\n-H 'Content-Type: application/json' \\\\\\n-d '{\\n    \\\"from\\\": \\\"5215500000001\\\",\\n    \\\"to\\\": \\\"5215500000002\\\",\\n    \\\"type\\\": \\\"template\\\",\\n    \\\"template\\\":\\n    {\\n        \\\"language\\\": \\\"es\\\",\\n        \\\"name\\\": \\\"body_text\\\",\\n        \\\"components\\\":[\\n            {\\n                \\\"type\\\":\\\"body\\\",\\n                \\\"parameters\\\":[\\n                    {\\n                        \\\"type\\\":\\\"text\\\",\\n                        \\\"text\\\":\\\"123456\\\"\\n                    }\\n                ]\\n            }\\n        ]\\n    }\\n}'\\n\")), mdx(\"p\", {\n    parentName: \"section\"\n  }, \"Si la ventana de servicio est\\xE1 abierta, puedes enviar texto libre reemplazando los campos \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"type\"), \" y \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"template\"), \" por \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"\\\"type\\\": \\\"text\\\"\"), \" y un campo \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"text\"), \":\"), mdx(\"pre\", {\n    parentName: \"section\"\n  }, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-bash\"\n  }, \"curl -X POST 'https://{{url}}/whatsapp-bsp-api-endpoint-ws/services/v1/messaging' \\\\\\n-H 'Authorization: Bearer {{wa-msg-api-token}}' \\\\\\n-H 'Content-Type: application/json' \\\\\\n-d '{\\n    \\\"from\\\": \\\"5215500000001\\\",\\n    \\\"to\\\": \\\"5215500000002\\\",\\n    \\\"type\\\": \\\"text\\\",\\n    \\\"text\\\": \\\"~Texto tachado~ \\\\n _Texto en cursivas_ \\\\n *Texto en negritas* \\\\n Emojis \\uD83D\\uDE0B\\\"\\n}'\\n\"))), mdx(\"section\", {\n    \"id\": \"paso2:leelarespuesta\"\n  }, mdx(\"h2\", {\n    parentName: \"section\"\n  }, \"Paso 2: Lee la respuesta\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, \"Una petici\\xF3n exitosa responde HTTP 200 con un ID de mensaje:\"), mdx(\"pre\", {\n    parentName: \"section\"\n  }, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-json\"\n  }, \"[\\n    {\\n        \\\"id\\\": \\\"gBGHUhVUByKUHwIJCSIVo3YWvs8i\\\"\\n    }\\n]\\n\")), mdx(\"p\", {\n    parentName: \"section\"\n  }, \"Guarda el \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"id\"), \": es la \\xFAnica forma de relacionar los callbacks de estatus de este mensaje.\"), mdx(Warning, {\n    mdxType: \"Warning\"\n  }, mdx(\"p\", {\n    parentName: \"section\"\n  }, \"HTTP 200 significa que la plataforma \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"acept\\xF3\"), \" la petici\\xF3n, no que el mensaje se haya entregado. La entrega solo se confirma con el callback de estatus \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"delivered\"), \" (paso 3). Los errores que se devuelven en este punto (\", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"400\"), \", \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"401\"), \", \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"500\"), \") se describen en \", mdx(\"a\", {\n    href: \"/whatsapp/messaging/http#h-respuesta\"\n  }, \"Respuesta\"), \".\"))), mdx(\"section\", {\n    \"id\": \"paso3:relacionaelcallbackdeestatus\"\n  }, mdx(\"h2\", {\n    parentName: \"section\"\n  }, \"Paso 3: Relaciona el callback de estatus\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, \"Tu webhook recibe callbacks de estatus con el mismo ID de mensaje. El estatus avanza por \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"sent\"), \" \\u2192 \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"delivered\"), \" \\u2192 \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"read\"), \", o termina en \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"failed\"), \". Los callbacks pueden llegar desordenados, as\\xED que relaci\\xF3nalos por \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"id\"), \", no por orden de llegada.\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, \"Todos los campos se describen en \", mdx(\"a\", {\n    href: \"/whatsapp/receive_notifications/statuses\"\n  }, \"Notificaciones de estatus\"), \".\")), mdx(\"section\", {\n    \"id\": \"paso3:relacionaelcallbackdeestatus--sent\"\n  }, mdx(\"h3\", {\n    parentName: \"section\"\n  }, \"sent\"), mdx(\"pre\", {\n    parentName: \"section\"\n  }, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-json\"\n  }, \"{\\n    \\\"statuses\\\": [\\n        {\\n            \\\"id\\\": \\\"gBGHUhVUByKUHwIJCSIVo3YWvs8i\\\",\\n            \\\"status\\\": \\\"sent\\\",\\n            \\\"timestamp\\\": \\\"1693419170\\\",\\n            \\\"recipient_id\\\": \\\"5215500000002\\\",\\n            \\\"conversation\\\":\\n            {\\n                \\\"id\\\": \\\"05b0852529d1652f2ccf3cde096f2150\\\",\\n                \\\"origin\\\":\\n                {\\n                    \\\"type\\\": \\\"utility\\\"\\n                }\\n            },\\n            \\\"pricing\\\":\\n            {\\n                \\\"billable\\\": true,\\n                \\\"pricing_model\\\": \\\"CBP\\\",\\n                \\\"category\\\": \\\"utility\\\"\\n            }\\n        }\\n    ]\\n}\\n\"))), mdx(\"section\", {\n    \"id\": \"paso3:relacionaelcallbackdeestatus--delivered\"\n  }, mdx(\"h3\", {\n    parentName: \"section\"\n  }, \"delivered\"), mdx(\"pre\", {\n    parentName: \"section\"\n  }, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-json\"\n  }, \"{\\n    \\\"statuses\\\": [\\n        {\\n            \\\"id\\\": \\\"gBGHUhVUByKUHwIJCSIVo3YWvs8i\\\",\\n            \\\"status\\\": \\\"delivered\\\",\\n            \\\"timestamp\\\": \\\"1693419173\\\",\\n            \\\"recipient_id\\\": \\\"5215500000002\\\",\\n            \\\"conversation\\\":\\n            {\\n                \\\"id\\\": \\\"05b0852529d1652f2ccf3cde096f2150\\\",\\n                \\\"origin\\\":\\n                {\\n                    \\\"type\\\": \\\"utility\\\"\\n                }\\n            },\\n            \\\"pricing\\\":\\n            {\\n                \\\"billable\\\": true,\\n                \\\"pricing_model\\\": \\\"CBP\\\",\\n                \\\"category\\\": \\\"utility\\\"\\n            }\\n        }\\n    ]\\n}\\n\"))), mdx(\"section\", {\n    \"id\": \"paso3:relacionaelcallbackdeestatus--read\"\n  }, mdx(\"h3\", {\n    parentName: \"section\"\n  }, \"read\"), mdx(\"pre\", {\n    parentName: \"section\"\n  }, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-json\"\n  }, \"{\\n    \\\"statuses\\\": [\\n        {\\n            \\\"id\\\": \\\"gBGHUhVUByKUHwIJCSIVo3YWvs8i\\\",\\n            \\\"status\\\": \\\"read\\\",\\n            \\\"timestamp\\\": \\\"1693419180\\\",\\n            \\\"recipient_id\\\": \\\"5215500000002\\\"\\n        }\\n    ]\\n}\\n\"))), mdx(\"section\", {\n    \"id\": \"paso3:relacionaelcallbackdeestatus--failed\"\n  }, mdx(\"h3\", {\n    parentName: \"section\"\n  }, \"failed\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, \"Por ejemplo, un mensaje libre enviado fuera de la ventana de servicio:\"), mdx(\"pre\", {\n    parentName: \"section\"\n  }, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-json\"\n  }, \"{\\n    \\\"statuses\\\": [\\n        {\\n            \\\"errors\\\": [\\n                {\\n                    \\\"code\\\": 470,\\n                    \\\"title\\\": \\\"Failed to send message because you are outside the support window for freeform messages to this user. Please use a valid HSM notification or reconsider.\\\"\\n                }\\n            ],\\n            \\\"id\\\": \\\"gBGHUhVUByKUHwIJCSIVo3YWvs8i\\\",\\n            \\\"recipient_id\\\": \\\"5215500000002\\\",\\n            \\\"status\\\": \\\"failed\\\",\\n            \\\"timestamp\\\": \\\"1693419173\\\"\\n        }\\n    ]\\n}\\n\")), mdx(\"p\", {\n    parentName: \"section\"\n  }, \"Cuando el estatus es \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"failed\"), \", busca \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"errors[].code\"), \" en \", mdx(\"a\", {\n    href: \"/whatsapp/error_codes\"\n  }, \"C\\xF3digos de error\"), \".\")));\n}\n;\nMDXContent.isMDXComponent = true;","tableOfContents":{"items":[{"url":"#antes-de-comenzar","title":"Antes de comenzar"},{"url":"#elige-el-tipo-de-mensaje","title":"Elige el tipo de mensaje"},{"url":"#paso-1-envía-el-mensaje","title":"Paso 1: Envía el mensaje"},{"url":"#paso-2-lee-la-respuesta","title":"Paso 2: Lee la respuesta"},{"url":"#paso-3-relaciona-el-callback-de-estatus","title":"Paso 3: Relaciona el callback de estatus","items":[{"url":"#sent","title":"sent"},{"url":"#delivered","title":"delivered"},{"url":"#read","title":"read"},{"url":"#failed","title":"failed"}]}]},"timeToRead":2,"parent":{"__typename":"File","relativePath":"es/whatsapp/messaging/quickstart.md","fields":null},"frontmatter":{"metaTitle":"Quickstart: Envía tu primer mensaje","showMetadata":null,"editable":null,"showPreviousNext":null,"showToc":null}},"gitBranch":{"name":"20211019-2FACTOR_AUTH"},"gitCommit":{"hash":"50a69cce8c40a2faa0cce76d4bf2bf9281a192c2","date":"2026-11-17 08:36"}},"pageContext":{"id":"c0c34082-e2fb-52fe-a000-a747c171aa94","lang":"es"}},"staticQueryHashes":["12478684","12478684","353167761","353167761","3960160274","3960160274","801980290","801980290"]}