{"id":651,"date":"2026-10-29T13:10:11","date_gmt":"2026-10-29T13:10:11","guid":{"rendered":"https:\/\/vectalk.com.br\/blog\/api-oficial-de-whatsapp\/"},"modified":"2026-10-29T13:10:34","modified_gmt":"2026-10-29T13:10:34","slug":"api-oficial-de-whatsapp","status":"publish","type":"post","link":"https:\/\/vectalk.com.br\/blog\/es\/api-oficial-de-whatsapp\/","title":{"rendered":"API oficial de WhatsApp: gu\u00eda completa (2026)"},"content":{"rendered":"\n<p><em>Actualizado el 29\/10\/2026<\/em><\/p>\n\n\n\n<p>La API oficial de WhatsApp es la WhatsApp Business Platform de Meta, que hoy se ofrece como Cloud API: una API HTTP alojada por la propia Meta que permite enviar y recibir mensajes desde tu sistema. Para usarla necesitas un portafolio comercial en Meta, un n\u00famero registrado en la plataforma, plantillas aprobadas para iniciar conversaciones y una forma de pago, ya que Meta cobra por mensaje entregado. Es el \u00fanico camino que Meta autoriza para automatizar el WhatsApp de una empresa.<\/p>\n\n\n\n<p>Esta gu\u00eda explica qu\u00e9 separa la API oficial de WhatsApp de las bibliotecas no oficiales, cu\u00e1les son los requisitos, c\u00f3mo elegir entre integrarte directo con Meta o usar un intermediario, cu\u00e1nto cuesta a grandes rasgos y en qu\u00e9 casos el cambio compensa.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Qu\u00e9 es la API oficial de WhatsApp<\/h2>\n\n\n\n<p>La WhatsApp Business Platform es el conjunto de APIs que Meta pone a disposici\u00f3n de las empresas. En la pr\u00e1ctica, cuando alguien habla hoy de &#8220;API oficial de WhatsApp&#8221;, se refiere a la <strong>Cloud API<\/strong>: endpoints de la Graph API (<code>graph.facebook.com<\/code>) que reciben JSON y devuelven JSON, y webhooks que avisan a tu servidor cuando llega un mensaje o cambia el estado de un mensaje enviado.<\/p>\n\n\n\n<p>Algunos t\u00e9rminos aparecen todo el tiempo en la documentaci\u00f3n de Meta. Conviene conocerlos antes de empezar:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>T\u00e9rmino<\/th><th>Qu\u00e9 es<\/th><th>D\u00f3nde aparece<\/th><\/tr><\/thead><tbody><tr><td>Portafolio comercial<\/td><td>La cuenta de la empresa en Meta (antes llamada Business Manager). Puede verificarse.<\/td><td><code>business_id<\/code><\/td><\/tr><tr><td>Cuenta de WhatsApp Business (WABA)<\/td><td>Desde el 23\/09\/2026, Meta la separa en cuenta de WhatsApp (el n\u00famero) y cuenta de mensajes (plantillas, facturaci\u00f3n, webhooks). Los IDs y endpoints anteriores siguen funcionando durante la transici\u00f3n.<\/td><td><code>waba_id<\/code><\/td><\/tr><tr><td>N\u00famero de tel\u00e9fono comercial<\/td><td>El n\u00famero registrado en la Cloud API, usado para enviar y recibir.<\/td><td><code>phone_number_id<\/code><\/td><\/tr><tr><td>Plantilla (template)<\/td><td>Mensaje aprobado previamente, obligatorio para iniciar contacto fuera de la ventana de atenci\u00f3n.<\/td><td><code>type: \"template\"<\/code><\/td><\/tr><tr><td>Ventana de atenci\u00f3n al cliente<\/td><td>Periodo de 24 horas que se abre con cada mensaje del cliente, en el que puedes responder con mensajes libres.<\/td><td>reglas de env\u00edo y precio<\/td><\/tr><tr><td>Webhook<\/td><td>URL de tu sistema que recibe eventos (mensajes recibidos, estados de entrega).<\/td><td><code>object: \"whatsapp_business_account\"<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>La nueva divisi\u00f3n de la cuenta se explica en <a href=\"https:\/\/vectalk.com.br\/blog\/es\/cuenta-whatsapp-cuenta-de-mensajes-waba\/\">Cuenta de WhatsApp y cuenta de mensajes: la nueva estructura de la WABA<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">API oficial vs. API no oficial<\/h2>\n\n\n\n<p>Bibliotecas como Baileys y WPPConnect, y las herramientas construidas sobre ellas (como el modo Baileys de Evolution API), funcionan emulando WhatsApp Web: escaneas un c\u00f3digo QR con el celular y el software pasa a controlar esa sesi\u00f3n. No hay contrato con Meta, no hay plantillas ni cobro por mensaje. Tampoco hay garant\u00eda de que la pr\u00f3xima actualizaci\u00f3n de WhatsApp no rompa la integraci\u00f3n.<\/p>\n\n\n\n<p>Las <a href=\"https:\/\/www.whatsapp.com\/legal\/terms-of-service\" target=\"_blank\" rel=\"noreferrer noopener\">Condiciones del servicio de WhatsApp<\/a> proh\u00edben acceder o usar el servicio por medios automatizados no autorizados y crear cuentas por medios no autorizados o automatizados. El texto tambi\u00e9n menciona el env\u00edo masivo y los mensajes autom\u00e1ticos entre las comunicaciones no permitidas. Por eso los n\u00fameros usados con APIs no oficiales pueden ser bloqueados sin aviso.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Criterio<\/th><th>API oficial (Cloud API)<\/th><th>API no oficial (Baileys, WPPConnect, etc.)<\/th><\/tr><\/thead><tbody><tr><td>Autorizaci\u00f3n de Meta<\/td><td>S\u00ed, es el producto de Meta para empresas<\/td><td>No; contradice las Condiciones del servicio<\/td><\/tr><tr><td>Conexi\u00f3n<\/td><td>Token de acceso y llamadas HTTP<\/td><td>Sesi\u00f3n de WhatsApp Web por c\u00f3digo QR<\/td><\/tr><tr><td>Riesgo de bloqueo por usar la herramienta<\/td><td>No; el riesgo viene de la calidad y la pol\u00edtica<\/td><td>Alto e impredecible<\/td><\/tr><tr><td>Iniciar conversaci\u00f3n<\/td><td>Solo con plantilla aprobada<\/td><td>Mensaje libre (y ah\u00ed est\u00e1 el riesgo)<\/td><\/tr><tr><td>Costo de mensajes<\/td><td>Por mensaje entregado, tarifa de Meta<\/td><td>Sin cobro de Meta<\/td><\/tr><tr><td>Estabilidad<\/td><td>Versionada, con changelog y fechas de descontinuaci\u00f3n<\/td><td>Depende de ingenier\u00eda inversa<\/td><\/tr><tr><td>Webhooks<\/td><td>Formato documentado por Meta<\/td><td>Formato propio de cada biblioteca<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Vale aclarar que Evolution API tambi\u00e9n ofrece integraci\u00f3n con la Cloud API oficial, adem\u00e1s de su modo basado en Baileys. Lo que define el riesgo es el canal, no el nombre de la herramienta. Si est\u00e1s en esa situaci\u00f3n, <a href=\"https:\/\/vectalk.com.br\/blog\/es\/migrar-a-api-oficial-de-whatsapp\/\">C\u00f3mo migrar de una API no oficial a la API oficial de WhatsApp<\/a> trae el paso a paso, y <a href=\"https:\/\/vectalk.com.br\/blog\/es\/api-oficial-vs-api-no-oficial-whatsapp\/\">API oficial vs. API no oficial de WhatsApp<\/a> profundiza en el riesgo de bloqueo.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Requisitos para usar la API oficial<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Portafolio comercial en Meta<\/h3>\n\n\n\n<p>Todo uso de la plataforma parte de un portafolio comercial. Ah\u00ed quedan la cuenta de WhatsApp y la cuenta de mensajes, los n\u00fameros, los usuarios del sistema y la forma de pago.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Verificaci\u00f3n de la empresa<\/h3>\n\n\n\n<p>La verificaci\u00f3n no es obligatoria para dar los primeros pasos, pero cambia lo que puedes hacer. Seg\u00fan la <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/messaging-limits\" target=\"_blank\" rel=\"noreferrer noopener\">documentaci\u00f3n de l\u00edmites de mensajes de Meta<\/a>, los portafolios nuevos empiezan con un l\u00edmite de 250 destinatarios \u00fanicos en 24 horas m\u00f3viles fuera de la ventana de atenci\u00f3n. Verificar la empresa es uno de los caminos para subir a 2.000 (los otros son que tu proveedor est\u00e9 verificado, o entregar 2.000 mensajes fuera de la ventana a n\u00fameros \u00fanicos en 30 d\u00edas con plantillas de alta calidad). El l\u00edmite de n\u00fameros registrados tambi\u00e9n depende de eso: los portafolios nuevos pueden registrar dos n\u00fameros, y el tope sube a 20 cuando la empresa se verifica o llega al l\u00edmite de 2.000.<\/p>\n\n\n\n<p>En el flujo de Vectalk, la <a href=\"https:\/\/docs.vectalk.com.br\/quickstart\">gu\u00eda r\u00e1pida<\/a> pide una cuenta de Meta Business verificada para conectar el n\u00famero. Por eso, trata la verificaci\u00f3n como parte del proyecto, no como un paso opcional. Nuestra gu\u00eda de <a href=\"https:\/\/vectalk.com.br\/blog\/es\/verificacion-empresa-meta-business\/\">verificaci\u00f3n de la empresa en Meta Business<\/a> detalla el proceso.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">N\u00famero de tel\u00e9fono<\/h3>\n\n\n\n<p>Seg\u00fan la <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/business-phone-numbers\/phone-numbers\" target=\"_blank\" rel=\"noreferrer noopener\">documentaci\u00f3n de n\u00fameros de tel\u00e9fono comerciales de Meta<\/a>, el n\u00famero debe:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>pertenecer a tu empresa;<\/li>\n\n\n<li>tener c\u00f3digo de pa\u00eds y de \u00e1rea (no se aceptan c\u00f3digos cortos);<\/li>\n\n\n<li>poder recibir SMS o llamada de voz con el c\u00f3digo de verificaci\u00f3n.<\/li>\n\n<\/ul>\n\n\n\n<p>Un punto que confunde a muchos: los n\u00fameros que ya est\u00e1n en uso en WhatsApp no se pueden registrar en la Cloud API sin antes eliminar la cuenta de la app. La excepci\u00f3n es el n\u00famero de la <strong>app WhatsApp Business<\/strong>, que se puede conectar a la API sin dejar de usar la app, en la funci\u00f3n conocida como coexistencia. Explicamos requisitos y limitaciones en <a href=\"https:\/\/vectalk.com.br\/blog\/es\/coexistencia-api-whatsapp\/\">Coexistencia en la API de WhatsApp<\/a>.<\/p>\n\n\n\n<p>Tambi\u00e9n necesitar\u00e1s un nombre visible. Seg\u00fan el nombre, Meta puede revisarlo antes de que se pueda usar.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Forma de pago<\/h3>\n\n\n\n<p>Desde el 1 de octubre de 2026, Meta cobra los mensajes de servicio que superan una franquicia mensual gratuita por n\u00famero. La <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/pricing\" target=\"_blank\" rel=\"noreferrer noopener\">p\u00e1gina de precios<\/a> indica que las cuentas sin forma de pago solo reciben entregas de mensajes de servicio dentro de esa franquicia. En la pr\u00e1ctica, toda operaci\u00f3n en producci\u00f3n necesita una facturaci\u00f3n activa: tu propia forma de pago en Meta o la l\u00ednea de cr\u00e9dito de un proveedor (con Vectalk es lo segundo; lo vemos m\u00e1s abajo).<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Consentimiento (opt-in) de los contactos<\/h3>\n\n\n\n<p>La <a href=\"https:\/\/whatsappbusiness.com\/policy\/\" target=\"_blank\" rel=\"noreferrer noopener\">Pol\u00edtica de mensajer\u00eda comercial de WhatsApp<\/a> solo permite contactar a quien te dio su n\u00famero y su permiso (opt-in) para recibir mensajes. Las solicitudes para dejar de recibir mensajes deben respetarse, incluso si se hacen fuera de WhatsApp. Esto vale para cualquier integraci\u00f3n oficial y es uno de los factores que m\u00e1s pesan en la calidad del n\u00famero.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">L\u00edmites que debes conocer<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>L\u00edmite<\/th><th>Valor por defecto<\/th><th>Observaci\u00f3n<\/th><\/tr><\/thead><tbody><tr><td>L\u00edmite de mensajes (fuera de la ventana)<\/td><td>250 destinatarios \u00fanicos \/ 24 h m\u00f3viles en portafolios nuevos<\/td><td>Sube a 2.000, 10.000, 100.000 e ilimitado seg\u00fan verificaci\u00f3n, volumen y calidad. Vale para todo el portafolio.<\/td><\/tr><tr><td>N\u00fameros registrados por portafolio<\/td><td>2 al inicio<\/td><td>Pasa a 20 con verificaci\u00f3n o al llegar al l\u00edmite de 2.000<\/td><\/tr><tr><td>Velocidad de env\u00edo (throughput)<\/td><td>80 mensajes por segundo por n\u00famero por defecto<\/td><td>Los n\u00fameros elegibles suben autom\u00e1ticamente hasta 1.000 mps; los n\u00fameros en coexistencia quedan en 20 mps<\/td><\/tr><tr><td>Ventana de atenci\u00f3n<\/td><td>24 horas desde el \u00faltimo mensaje del cliente<\/td><td>Fuera de ella, solo plantillas<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Fuentes: <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/messaging-limits\" target=\"_blank\" rel=\"noreferrer noopener\">l\u00edmites de mensajes<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/business-phone-numbers\/phone-numbers\" target=\"_blank\" rel=\"noreferrer noopener\">n\u00fameros de tel\u00e9fono<\/a> y <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/throughput\" target=\"_blank\" rel=\"noreferrer noopener\">velocidad de env\u00edo<\/a>.<\/p>\n\n\n\n<p>Un detalle importante: el l\u00edmite de mensajes es del portafolio, no del n\u00famero. Si tienes tres n\u00fameros en el mismo portafolio, uno de ellos puede consumir toda la capacidad del d\u00eda. Por encima de 2.000, el l\u00edmite sube solo cuando la calidad es alta y usaste al menos la mitad en los \u00faltimos 7 d\u00edas.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">C\u00f3mo funciona la conversaci\u00f3n: ventana de 24 horas y plantillas<\/h2>\n\n\n\n<p>La regla central de la API oficial es simple. Cuando el cliente env\u00eda un mensaje, se abre una ventana de atenci\u00f3n de 24 horas. Dentro de ella respondes con cualquier tipo de mensaje: texto, imagen, botones, listas. Cada nuevo mensaje del cliente reinicia el contador.<\/p>\n\n\n\n<p>Fuera de la ventana solo puedes enviar plantillas. Se crean con una categor\u00eda (marketing, utilidad o autenticaci\u00f3n), pasan por la aprobaci\u00f3n de Meta y aceptan variables. Una plantilla de confirmaci\u00f3n de pedido, por ejemplo:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code class=\"language-json\">{\n  \"messaging_product\": \"whatsapp\",\n  \"to\": \"5584999999999\",\n  \"type\": \"template\",\n  \"template\": {\n    \"name\": \"order_confirmation\",\n    \"language\": { \"code\": \"es\" },\n    \"components\": [\n      {\n        \"type\": \"body\",\n        \"parameters\": [\n          { \"type\": \"text\", \"text\": \"Mar\u00eda\" },\n          { \"type\": \"text\", \"text\": \"#12345\" }\n        ]\n      }\n    ]\n  }\n}<\/code><\/pre>\n\n\n\n<p>Es el mismo payload que aceptan Meta y Vectalk. La categor\u00eda de la plantilla tambi\u00e9n define el precio del mensaje, tema que detallamos en <a href=\"https:\/\/vectalk.com.br\/blog\/es\/precio-api-whatsapp-brasil\/\">Precio de la API de WhatsApp en Brasil<\/a>.<\/p>\n\n\n\n<p>Un cambio para planificar: Meta est\u00e1 llevando las plantillas de marketing a la Marketing Messages API. La Cloud API (<code>\/messages<\/code>) deja de enviar marketing el 13\/10\/2027, y las cuentas de mensajes creadas a partir del 13\/04\/2027 ya no pueden enviarlo por ah\u00ed. Consulta <a href=\"https:\/\/vectalk.com.br\/blog\/es\/marketing-messages-api-whatsapp-es\/\">Marketing Messages API: c\u00f3mo migrar<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Solution Partner, Tech Provider o Cloud API directa<\/h2>\n\n\n\n<p>Hay tres formas de llegar a la Cloud API. La diferencia est\u00e1 en qui\u00e9n se encarga de la app en Meta, los tokens, los webhooks y la facturaci\u00f3n.<\/p>\n\n\n\n<p><strong>Integraci\u00f3n directa.<\/strong> Creas una app en el panel de Meta, generas un token de usuario del sistema, configuras el webhook con verificaci\u00f3n y firma, suscribes los campos de la cuenta y te encargas de rotar las credenciales. No hay intermediario, pero toda la operaci\u00f3n queda en manos de tu equipo.<\/p>\n\n\n\n<p><strong>Socios de Meta.<\/strong> La <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/solution-providers\/overview\" target=\"_blank\" rel=\"noreferrer noopener\">documentaci\u00f3n para proveedores de soluciones<\/a> divide a los intermediarios en tres tipos:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Solution Partners<\/strong> (lo que el mercado llama BSP): son Meta Business Partners, pueden extender una l\u00ednea de cr\u00e9dito a sus clientes y cobrarles directamente por el uso de la plataforma.<\/li>\n\n\n<li><strong>Tech Providers<\/strong>: ofrecen servicios sobre la plataforma, pero sin l\u00ednea de cr\u00e9dito. El cliente registra su propia forma de pago y Meta le cobra el uso de la API directamente.<\/li>\n\n\n<li><strong>Tech Partners<\/strong>: Tech Providers que son, o pueden llegar a ser, Meta Business Partners.<\/li>\n\n<\/ul>\n\n\n\n<p><strong>Proxy gestionado.<\/strong> Es el modelo de Vectalk. Tu aplicaci\u00f3n habla con Vectalk, que reenv\u00eda las llamadas a la Cloud API. Los payloads son los mismos de Meta; solo cambian la URL base y el token:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th><\/th><th>Cloud API directa<\/th><th>Vectalk<\/th><\/tr><\/thead><tbody><tr><td>URL base<\/td><td><code>https:\/\/graph.facebook.com\/vXX.X<\/code><\/td><td><code>https:\/\/apis.vectalk.com.br\/api<\/code><\/td><\/tr><tr><td>Token<\/td><td>Token de acceso de Meta (usuario del sistema)<\/td><td>Token generado en Vectalk<\/td><\/tr><tr><td>Payloads<\/td><td>Formato de Meta<\/td><td>Igual al de Meta<\/td><\/tr><tr><td>Varias cuentas<\/td><td>Un token y un <code>phone_number_id<\/code> por contexto<\/td><td>Un token de organizaci\u00f3n para todas las instancias, enviando el <code>phone_number_id<\/code><\/td><\/tr><tr><td>Webhooks<\/td><td>Un endpoint por app, configurado en el panel de Meta<\/td><td>Varias URLs por instancia, registradas v\u00eda API<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>En Vectalk, el env\u00edo de un mensaje de texto queda as\u00ed:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code class=\"language-bash\">curl -X POST https:\/\/apis.vectalk.com.br\/api\/messages \\\n  -H \"Authorization: Bearer TU_TOKEN\" \\\n  -H \"Content-Type: application\/json\" \\\n  -d '{\n    \"messaging_product\": \"whatsapp\",\n    \"to\": \"5584999999999\",\n    \"type\": \"text\",\n    \"text\": { \"body\": \"Tu pedido sali\u00f3 para entrega.\" }\n  }'<\/code><\/pre>\n\n\n\n<p>Si ya tienes c\u00f3digo escrito para la Cloud API, migrar al proxy es cambiar dos variables de entorno. Los detalles del token de organizaci\u00f3n y de instancia est\u00e1n en la p\u00e1gina de <a href=\"https:\/\/docs.vectalk.com.br\/authentication\">autenticaci\u00f3n<\/a>. Para comparar las opciones, lee <a href=\"https:\/\/vectalk.com.br\/blog\/es\/api-whatsapp-directo-meta-o-proveedor\/\">\u00bfAPI de WhatsApp directo con Meta o con un proveedor?<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Costos a grandes rasgos<\/h2>\n\n\n\n<p>Desde el 1 de julio de 2025, Meta cobra <strong>por mensaje entregado<\/strong>, con precio definido por la categor\u00eda del mensaje y el c\u00f3digo de pa\u00eds del destinatario. Las categor\u00edas de plantilla son marketing, utilidad y autenticaci\u00f3n; los mensajes sin plantilla son de servicio, y desde el 1 de julio de 2026 existe tambi\u00e9n Meta Business Agent, para respuestas generadas por la IA de la propia Meta, cobrado a una tarifa global de US$ 2,00 por 1 mill\u00f3n de tokens. Algunos mensajes no se cobran: los enviados dentro de la ventana de punto de entrada gratuito que abren los anuncios Click-to-WhatsApp (puede quedar abierta hasta 7 d\u00edas; los mensajes de Meta Business Agent se cobran igual dentro de ella) y los primeros 1.000 mensajes de servicio del mes, por n\u00famero. Desde el 1 de octubre de 2026, las plantillas de utilidad enviadas dentro de la ventana de atenci\u00f3n se cobran.<\/p>\n\n\n\n<p>En Brasil, Meta publica la tarifa oficial en reales (BRL), y las cuentas en BRL las factura Facebook Brasil. Valores, tramos de volumen y los cambios de octubre de 2026 est\u00e1n en <a href=\"https:\/\/vectalk.com.br\/blog\/es\/precio-api-whatsapp-brasil\/\">Precio de la API de WhatsApp en Brasil<\/a>. Si tus clientes est\u00e1n en otros pa\u00edses, consulta el <a href=\"https:\/\/vectalk.com.br\/blog\/es\/precio-api-whatsapp-por-pais\/\">precio de la API de WhatsApp por pa\u00eds<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Cu\u00e1ndo conviene la API oficial<\/h2>\n\n\n\n<p>Compensa cuando WhatsApp es parte del producto o de la operaci\u00f3n, y no un canal secundario:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Sistemas que necesitan notificar a clientes<\/strong>: confirmaci\u00f3n de pedido, recordatorio de cita, segunda v\u00eda de <em>boleto<\/em> (el comprobante de pago bancario de Brasil), c\u00f3digo de verificaci\u00f3n.<\/li>\n\n\n<li><strong>Atenci\u00f3n con varias personas o con IA<\/strong>: un n\u00famero, varios agentes o un agente autom\u00e1tico respondiendo, con historial en tu sistema.<\/li>\n\n\n<li><strong>SaaS que ofrece WhatsApp a sus propios clientes<\/strong>: CRMs, ERPs, plataformas de agendamiento y de e-commerce que necesitan conectar n\u00fameros de terceros con seguridad.<\/li>\n\n\n<li><strong>Operaciones que no pueden parar<\/strong>: cualquier flujo en el que el bloqueo de un n\u00famero sale caro.<\/li>\n\n<\/ul>\n\n\n\n<p>Y conviene menos en algunos casos:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>cuando el uso es solo conversaci\u00f3n manual, con pocos mensajes al d\u00eda, y la app WhatsApp Business alcanza;<\/li>\n\n\n<li>cuando el plan depende de enviar mensajes a listas sin consentimiento, algo que la pol\u00edtica no permite en ninguna API oficial;<\/li>\n\n\n<li>cuando el flujo depende de funciones que la Cloud API no cubre o cubre con l\u00edmites. La API de Grupos, por ejemplo, exige una cuenta comercial oficial y admite como m\u00e1ximo 8 participantes por grupo, seg\u00fan la <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/groups\" target=\"_blank\" rel=\"noreferrer noopener\">documentaci\u00f3n de grupos<\/a>.<\/li>\n\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Primeros pasos con Vectalk<\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Crea tu cuenta en <a href=\"https:\/\/apps.vectalk.com.br\/register\">apps.vectalk.com.br\/register<\/a>. Se crea una organizaci\u00f3n autom\u00e1ticamente.<\/li>\n\n\n<li>En <strong>Instancias<\/strong> (<em>Inst\u00e2ncias<\/em> en la interfaz en portugu\u00e9s), haz clic en <strong>Conectar cuenta<\/strong> (<em>Conectar conta<\/em> en la interfaz en portugu\u00e9s) y completa el Registro insertado (Embedded Signup) de Meta. Vectalk importa el <code>phone_number_id<\/code>, el <code>waba_id<\/code> y el token de acceso.<\/li>\n\n\n<li>En <strong>Configuraci\u00f3n \u2192 API Tokens<\/strong> (<em>Configura\u00e7\u00f5es \u2192 API Tokens<\/em> en la interfaz en portugu\u00e9s), genera un token de organizaci\u00f3n o de instancia. Se muestra una sola vez.<\/li>\n\n\n<li>Env\u00eda el primer mensaje con <code>POST \/api\/messages<\/code> y registra un webhook con <code>POST \/api\/webhooks<\/code>.<\/li>\n\n<\/ol>\n\n\n\n<p>La facturaci\u00f3n funciona con mensualidad m\u00e1s saldo prepago: Vectalk coloca su propia l\u00ednea de cr\u00e9dito en tu n\u00famero, cada mensaje entregado se descuenta del saldo y no registras tarjeta en Meta. El paso a paso completo est\u00e1 en la <a href=\"https:\/\/docs.vectalk.com.br\/quickstart\">gu\u00eda r\u00e1pida de la documentaci\u00f3n<\/a>. Para dudas de cuenta y facturaci\u00f3n, <a href=\"https:\/\/vectalk.com.br\/contato.html\">cont\u00e1ctanos<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Preguntas frecuentes<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">\u00bfLa API oficial de WhatsApp es gratuita?<\/h3>\n\n\n\n<p>No. Meta cobra por mensaje entregado, seg\u00fan la categor\u00eda y el pa\u00eds del destinatario. Hay casos sin cobro, como la franquicia de 1.000 mensajes de servicio por mes por n\u00famero y los mensajes dentro de la ventana de punto de entrada gratuito. El intermediario que elijas puede cobrar aparte por su servicio.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\u00bfNecesito un CNPJ para usar la API oficial?<\/h3>\n\n\n\n<p>El CNPJ es el registro de empresas de Brasil. Meta exige un portafolio comercial, y la verificaci\u00f3n de la empresa pide documentos de la organizaci\u00f3n. Revisa el servicio de ayuda para empresas de Meta para ver qu\u00e9 documentos se aceptan en tu pa\u00eds antes de empezar.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\u00bfPuedo usar el mismo n\u00famero que ya uso en el celular?<\/h3>\n\n\n\n<p>Si el n\u00famero est\u00e1 en la app WhatsApp Business, puedes conectarlo a la API sin salir de la app, mediante la coexistencia. Si est\u00e1 en WhatsApp com\u00fan (Messenger), debes eliminar la cuenta de la app antes de registrar el n\u00famero en la Cloud API.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\u00bfCu\u00e1l es la diferencia entre la API oficial y la app WhatsApp Business?<\/h3>\n\n\n\n<p>La app est\u00e1 hecha para uso manual en el celular y la computadora. La API es para sistemas: env\u00edo program\u00e1tico, webhooks, varios agentes, integraciones y automatizaci\u00f3n. La API tiene reglas de plantillas y de ventana de 24 horas que la app no tiene.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\u00bfCu\u00e1nto tiempo lleva ponerla en marcha?<\/h3>\n\n\n\n<p>La integraci\u00f3n t\u00e9cnica suele ser r\u00e1pida cuando el equipo ya conoce APIs REST. Lo que suele demorar es la parte de Meta: verificaci\u00f3n de la empresa y aprobaci\u00f3n del nombre visible y de las plantillas. Planifica esas etapas con anticipaci\u00f3n.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<p><strong>Fuentes oficiales consultadas el 29\/10\/2026:<\/strong> <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/pricing\" target=\"_blank\" rel=\"noreferrer noopener\">Precios de WhatsApp Business Platform<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/messaging-limits\" target=\"_blank\" rel=\"noreferrer noopener\">L\u00edmites de mensajes<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/business-phone-numbers\/phone-numbers\" target=\"_blank\" rel=\"noreferrer noopener\">N\u00fameros de tel\u00e9fono comerciales<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/throughput\" target=\"_blank\" rel=\"noreferrer noopener\">Velocidad de env\u00edo (throughput)<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/solution-providers\/overview\" target=\"_blank\" rel=\"noreferrer noopener\">Proveedores de soluciones<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/account-model-evolution\/\" target=\"_blank\" rel=\"noreferrer noopener\">Evoluci\u00f3n del modelo de cuentas<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/marketing-messages\/overview\" target=\"_blank\" rel=\"noreferrer noopener\">Marketing Messages API<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/groups\" target=\"_blank\" rel=\"noreferrer noopener\">Grupos<\/a>, <a href=\"https:\/\/www.whatsapp.com\/legal\/terms-of-service\" target=\"_blank\" rel=\"noreferrer noopener\">Condiciones del servicio de WhatsApp<\/a>, <a href=\"https:\/\/whatsappbusiness.com\/policy\/\" target=\"_blank\" rel=\"noreferrer noopener\">Pol\u00edtica de mensajer\u00eda comercial de WhatsApp<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Qu\u00e9 es la API oficial de WhatsApp, en qu\u00e9 se diferencia de las bibliotecas no oficiales, qu\u00e9 necesitas para usarla, sus l\u00edmites y costos, y cu\u00e1ndo vale la pena.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_feature_clip_id":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_post_was_ever_published":false},"categories":[12],"tags":[],"class_list":["post-651","post","type-post","status-publish","format-standard","hentry","category-uncategorized-es"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v28.7 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>API oficial de WhatsApp: gu\u00eda completa 2026 | Vectalk<\/title>\n<meta name=\"description\" content=\"La API oficial de WhatsApp explicada: diferencias con APIs no oficiales, requisitos, proveedor o Cloud API directa, l\u00edmites, costos y cu\u00e1ndo conviene.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vectalk.com.br\/blog\/es\/api-oficial-de-whatsapp\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"API oficial de WhatsApp: gu\u00eda completa 2026 | Vectalk\" \/>\n<meta property=\"og:description\" content=\"La API oficial de WhatsApp explicada: diferencias con APIs no oficiales, requisitos, proveedor o Cloud API directa, l\u00edmites, costos y cu\u00e1ndo conviene.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vectalk.com.br\/blog\/es\/api-oficial-de-whatsapp\/\" \/>\n<meta property=\"og:site_name\" content=\"Blog Vectalk\" \/>\n<meta property=\"article:published_time\" content=\"2026-10-29T13:10:11+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-10-29T13:10:34+00:00\" \/>\n<meta name=\"author\" content=\"wanderleyfcunha\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"wanderleyfcunha\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"15 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/es\\\/api-oficial-de-whatsapp\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/es\\\/api-oficial-de-whatsapp\\\/\"},\"author\":{\"name\":\"wanderleyfcunha\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#\\\/schema\\\/person\\\/ff36ecd9d8257856f227f8e5d639db2b\"},\"headline\":\"API oficial de WhatsApp: gu\u00eda completa (2026)\",\"datePublished\":\"2026-10-29T13:10:11+00:00\",\"dateModified\":\"2026-10-29T13:10:34+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/es\\\/api-oficial-de-whatsapp\\\/\"},\"wordCount\":2896,\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/es\\\/api-oficial-de-whatsapp\\\/\",\"url\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/es\\\/api-oficial-de-whatsapp\\\/\",\"name\":\"API oficial de WhatsApp: gu\u00eda completa 2026 | Vectalk\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#website\"},\"datePublished\":\"2026-10-29T13:10:11+00:00\",\"dateModified\":\"2026-10-29T13:10:34+00:00\",\"author\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#\\\/schema\\\/person\\\/ff36ecd9d8257856f227f8e5d639db2b\"},\"description\":\"La API oficial de WhatsApp explicada: diferencias con APIs no oficiales, requisitos, proveedor o Cloud API directa, l\u00edmites, costos y cu\u00e1ndo conviene.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/es\\\/api-oficial-de-whatsapp\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/es\\\/api-oficial-de-whatsapp\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/es\\\/api-oficial-de-whatsapp\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API oficial de WhatsApp: gu\u00eda completa (2026)\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#website\",\"url\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/\",\"name\":\"Blog Vectalk\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#\\\/schema\\\/person\\\/ff36ecd9d8257856f227f8e5d639db2b\",\"name\":\"wanderleyfcunha\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g\",\"caption\":\"wanderleyfcunha\"},\"sameAs\":[\"https:\\\/\\\/vectalk.com.br\\\/blog\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"API oficial de WhatsApp: gu\u00eda completa 2026 | Vectalk","description":"La API oficial de WhatsApp explicada: diferencias con APIs no oficiales, requisitos, proveedor o Cloud API directa, l\u00edmites, costos y cu\u00e1ndo conviene.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vectalk.com.br\/blog\/es\/api-oficial-de-whatsapp\/","og_locale":"en_US","og_type":"article","og_title":"API oficial de WhatsApp: gu\u00eda completa 2026 | Vectalk","og_description":"La API oficial de WhatsApp explicada: diferencias con APIs no oficiales, requisitos, proveedor o Cloud API directa, l\u00edmites, costos y cu\u00e1ndo conviene.","og_url":"https:\/\/vectalk.com.br\/blog\/es\/api-oficial-de-whatsapp\/","og_site_name":"Blog Vectalk","article_published_time":"2026-10-29T13:10:11+00:00","article_modified_time":"2026-10-29T13:10:34+00:00","author":"wanderleyfcunha","twitter_card":"summary_large_image","twitter_misc":{"Written by":"wanderleyfcunha","Est. reading time":"15 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/vectalk.com.br\/blog\/es\/api-oficial-de-whatsapp\/#article","isPartOf":{"@id":"https:\/\/vectalk.com.br\/blog\/es\/api-oficial-de-whatsapp\/"},"author":{"name":"wanderleyfcunha","@id":"https:\/\/vectalk.com.br\/blog\/#\/schema\/person\/ff36ecd9d8257856f227f8e5d639db2b"},"headline":"API oficial de WhatsApp: gu\u00eda completa (2026)","datePublished":"2026-10-29T13:10:11+00:00","dateModified":"2026-10-29T13:10:34+00:00","mainEntityOfPage":{"@id":"https:\/\/vectalk.com.br\/blog\/es\/api-oficial-de-whatsapp\/"},"wordCount":2896,"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/vectalk.com.br\/blog\/es\/api-oficial-de-whatsapp\/","url":"https:\/\/vectalk.com.br\/blog\/es\/api-oficial-de-whatsapp\/","name":"API oficial de WhatsApp: gu\u00eda completa 2026 | Vectalk","isPartOf":{"@id":"https:\/\/vectalk.com.br\/blog\/#website"},"datePublished":"2026-10-29T13:10:11+00:00","dateModified":"2026-10-29T13:10:34+00:00","author":{"@id":"https:\/\/vectalk.com.br\/blog\/#\/schema\/person\/ff36ecd9d8257856f227f8e5d639db2b"},"description":"La API oficial de WhatsApp explicada: diferencias con APIs no oficiales, requisitos, proveedor o Cloud API directa, l\u00edmites, costos y cu\u00e1ndo conviene.","breadcrumb":{"@id":"https:\/\/vectalk.com.br\/blog\/es\/api-oficial-de-whatsapp\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vectalk.com.br\/blog\/es\/api-oficial-de-whatsapp\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/vectalk.com.br\/blog\/es\/api-oficial-de-whatsapp\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vectalk.com.br\/blog\/"},{"@type":"ListItem","position":2,"name":"API oficial de WhatsApp: gu\u00eda completa (2026)"}]},{"@type":"WebSite","@id":"https:\/\/vectalk.com.br\/blog\/#website","url":"https:\/\/vectalk.com.br\/blog\/","name":"Blog Vectalk","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vectalk.com.br\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/vectalk.com.br\/blog\/#\/schema\/person\/ff36ecd9d8257856f227f8e5d639db2b","name":"wanderleyfcunha","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g","caption":"wanderleyfcunha"},"sameAs":["https:\/\/vectalk.com.br\/blog"]}]}},"jetpack_sharing_enabled":true,"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/posts\/651","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/comments?post=651"}],"version-history":[{"count":1,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/posts\/651\/revisions"}],"predecessor-version":[{"id":653,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/posts\/651\/revisions\/653"}],"wp:attachment":[{"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/media?parent=651"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/categories?post=651"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/tags?post=651"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}