{"id":716,"date":"2026-10-29T13:17:33","date_gmt":"2026-10-29T13:17:33","guid":{"rendered":"https:\/\/vectalk.com.br\/blog\/envio-masivo-whatsapp-api-oficial\/"},"modified":"2026-10-29T13:18:11","modified_gmt":"2026-10-29T13:18:11","slug":"envio-masivo-whatsapp-api-oficial","status":"publish","type":"post","link":"https:\/\/vectalk.com.br\/blog\/es\/envio-masivo-whatsapp-api-oficial\/","title":{"rendered":"Env\u00edo masivo por la API oficial de WhatsApp: c\u00f3mo hacerlo sin perder el n\u00famero"},"content":{"rendered":"\n<p><em>Actualizado el 29\/10\/2026<\/em><\/p>\n\n\n\n<p>El env\u00edo masivo por la API oficial de WhatsApp es el env\u00edo de una plantilla de marketing aprobada por Meta a una lista de personas que dieron su consentimiento para recibir mensajes de tu empresa. El volumen lo controlan tres l\u00edmites: a cu\u00e1ntas personas puede llegar el portafolio en 24 horas, cu\u00e1ntos mensajes de marketing acepta recibir cada usuario y cu\u00e1ntos mensajes por segundo env\u00eda el n\u00famero. Para destinatarios en Brasil, cada plantilla de marketing entregada cuesta R$ 0,3217 (reales brasile\u00f1os) en la tabla de Meta, y las listas sin opt-in generan bloqueos y denuncias que terminan en restricciones de la cuenta.<\/p>\n\n\n\n<p>Esta gu\u00eda cubre lo que exige Meta, c\u00f3mo planificar la campa\u00f1a, cu\u00e1nto cuesta y un ejemplo de env\u00edo en Node.js que maneja los errores que importan.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Lo que exige Meta para el env\u00edo masivo<\/h2>\n\n\n\n<p>La API no tiene un endpoint de &#8220;difusi\u00f3n&#8221;. Cada mensaje es una llamada de env\u00edo de plantilla para un destinatario. Lo que convierte eso en campa\u00f1a es tu sistema: la lista, la programaci\u00f3n, el control de ritmo y la lectura de los estados.<\/p>\n\n\n\n<p>Tres reglas valen para cualquier campa\u00f1a:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Plantilla aprobada.<\/strong> Fuera de la ventana de 24 horas abierta por el cliente, solo se pueden enviar plantillas. Para promociones, ofertas y novedades, la categor\u00eda es marketing. Mira <a href=\"https:\/\/vectalk.com.br\/blog\/es\/plantillas-api-whatsapp\/\">plantillas de la API de WhatsApp<\/a> y <a href=\"https:\/\/vectalk.com.br\/blog\/es\/categorias-plantillas-whatsapp\/\">c\u00f3mo clasifica Meta las plantillas<\/a>.<\/li>\n\n\n<li><strong>Opt-in.<\/strong> La empresa necesita el n\u00famero del cliente y un permiso que confirme que quiere recibir sus mensajes.<\/li>\n\n\n<li><strong>Respeto al opt-out.<\/strong> La pol\u00edtica exige atender todos los pedidos de dejar de recibir mensajes, hechos dentro o fuera de WhatsApp.<\/li>\n\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Opt-in: qu\u00e9 pide Meta y c\u00f3mo registrarlo<\/h2>\n\n\n\n<p>La p\u00e1gina <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/getting-opt-in\" target=\"_blank\" rel=\"noreferrer noopener\">Get opt-in for WhatsApp<\/a> enumera tres requisitos:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Dejar claro que la persona acepta recibir comunicaciones de la empresa.<\/li>\n\n\n<li>Dejar claro el nombre de la empresa de la que va a recibir mensajes.<\/li>\n\n\n<li>Cumplir la legislaci\u00f3n aplicable.<\/li>\n\n<\/ol>\n\n\n\n<p>El opt-in puede ser general, sin mencionar WhatsApp espec\u00edficamente, siempre que cumpla la ley local. El m\u00e9todo queda a criterio de la empresa: sitio web, SMS, llamada con IVR o papel firmado en la tienda. Meta recomienda opt-ins separados por categor\u00eda de mensaje (pedidos, ofertas, recomendaciones), porque eso reduce el riesgo de bloqueo por mensajes inesperados. Para armar y mantener la lista, mira <a href=\"https:\/\/vectalk.com.br\/blog\/es\/lista-opt-in-whatsapp-es\/\">lista opt-in para WhatsApp<\/a>.<\/p>\n\n\n\n<p>Un texto de casilla que cumple los requisitos:<\/p>\n\n\n\n<p><em>&#8220;Quiero recibir ofertas y novedades de Tienda Ejemplo por WhatsApp. Puedo darme de baja cuando quiera respondiendo BAJA.&#8221;<\/em><\/p>\n\n\n\n<p>Guarda la prueba del consentimiento junto al contacto. Si alguna vez se impugna, ese registro muestra cu\u00e1ndo y c\u00f3mo la persona acept\u00f3:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code class=\"language-json\">{\n  \"wa_id\": \"5584999999999\",\n  \"optin\": {\n    \"categoria\": \"marketing\",\n    \"origen\": \"checkout_sitio\",\n    \"texto_aceptado\": \"Quiero recibir ofertas y novedades de Tienda Ejemplo por WhatsApp.\",\n    \"aceptado_en\": \"2026-10-12T14:32:10-03:00\",\n    \"ip\": \"200.0.0.10\"\n  },\n  \"optout\": null\n}<\/code><\/pre>\n\n\n\n<p>Adem\u00e1s de la pol\u00edtica de Meta, el tratamiento de estos datos est\u00e1 sujeto a la ley de protecci\u00f3n de datos: en Brasil, la LGPD (Ley General de Protecci\u00f3n de Datos); en otros pa\u00edses, la ley local correspondiente. Consulta con el \u00e1rea legal la base legal, el plazo de conservaci\u00f3n y la forma de revocar el consentimiento; este art\u00edculo no es asesor\u00eda jur\u00eddica. Mira <a href=\"https:\/\/vectalk.com.br\/blog\/es\/lgpd-whatsapp-es\/\">LGPD y WhatsApp<\/a> para las reglas brasile\u00f1as.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Opt-out dentro de WhatsApp<\/h3>\n\n\n\n<p>Hay dos caminos de salida que tu sistema debe manejar:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Bot\u00f3n en la plantilla.<\/strong> Incluye un bot\u00f3n de respuesta r\u00e1pida como &#8220;No quiero ofertas&#8221;. Cuando el cliente lo toca, el webhook llega con <code>type: \"button\"<\/code> y el texto del bot\u00f3n en <code>button.text<\/code>. Marca el contacto como opt-out de inmediato.<\/li>\n\n\n<li><strong>Configuraci\u00f3n del propio WhatsApp.<\/strong> El usuario puede dejar de recibir los mensajes de marketing de tu empresa desde la configuraci\u00f3n de WhatsApp. Si intentas enviar igual, el webhook de estado vuelve con <code>failed<\/code> y el error <code>131050<\/code>, seg\u00fan la <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/templates\/marketing-templates\" target=\"_blank\" rel=\"noreferrer noopener\">documentaci\u00f3n de plantillas de marketing<\/a>. Trata ese error como opt-out; el webhook <code>user_preferences<\/code> tambi\u00e9n te avisa cuando un usuario deja o retoma estos mensajes.<\/li>\n\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Los l\u00edmites que controlan el volumen<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>L\u00edmite<\/th><th>C\u00f3mo funciona<\/th><th>Error o se\u00f1al<\/th><th>Qu\u00e9 hacer<\/th><\/tr><\/thead><tbody><tr><td>L\u00edmite de mensajes del portafolio<\/td><td>Destinatarios \u00fanicos fuera de la ventana de atenci\u00f3n en 24 h m\u00f3viles: 250, 2.000, 10.000, 100.000 o ilimitado<\/td><td>Nivel actual en WhatsApp Manager y en el campo <code>whatsapp_business_manager_messaging_limit<\/code><\/td><td>Distribuye la campa\u00f1a en varios d\u00edas y sigue el nivel en WhatsApp Manager<\/td><\/tr><tr><td>L\u00edmite de marketing por usuario<\/td><td>Meta limita cu\u00e1ntas plantillas de marketing recibe cada persona de todas las empresas, seg\u00fan su interacci\u00f3n reciente<\/td><td>Estado <code>failed<\/code> con error <code>131049<\/code><\/td><td>No reenv\u00edes antes de 24 horas<\/td><\/tr><tr><td>Velocidad de env\u00edo (throughput)<\/td><td>Hasta 80 mensajes por segundo por n\u00famero, por defecto; los n\u00fameros en coexistencia con la app quedan fijos en 20<\/td><td>Error <code>130429<\/code> en la respuesta de la API<\/td><td>Baja el ritmo y reintenta con espera creciente<\/td><\/tr><tr><td>Calidad de la plantilla<\/td><td>Las plantillas de baja calidad se pausan: 3 horas la primera vez, 6 horas la segunda y se desactivan la tercera<\/td><td>Webhook de estado de la plantilla<\/td><td>Det\u00e9n la campa\u00f1a que usa la plantilla pausada<\/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\/templates\/marketing-templates\/per-user-limits\" target=\"_blank\" rel=\"noreferrer noopener\">l\u00edmites de marketing por usuario<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/throughput\" target=\"_blank\" rel=\"noreferrer noopener\">throughput<\/a> y <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/templates\/template-pausing\" target=\"_blank\" rel=\"noreferrer noopener\">pausa de plantillas<\/a>.<\/p>\n\n\n\n<p>Dos detalles sorprenden a quien planifica su primera campa\u00f1a:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>El l\u00edmite es del portafolio, no del n\u00famero.<\/strong> Todos los n\u00fameros de un portafolio comparten el mismo l\u00edmite. Comprar m\u00e1s n\u00fameros no multiplica el alcance.<\/li>\n\n\n<li><strong>El l\u00edmite por usuario no depende de ti.<\/strong> Aun con opt-in, parte de los destinatarios puede no recibir el mensaje porque ya recibi\u00f3 mucho marketing de otras empresas. Los mensajes de marketing enviados dentro de una ventana de atenci\u00f3n abierta por la respuesta del cliente no cuentan para ese l\u00edmite. El art\u00edculo sobre el <a href=\"https:\/\/vectalk.com.br\/blog\/es\/error-131049-whatsapp-limite-marketing\/\">error 131049<\/a> explica qu\u00e9 hacer.<\/li>\n\n<\/ul>\n\n\n\n<p>El art\u00edculo sobre el <a href=\"https:\/\/vectalk.com.br\/blog\/es\/limite-de-mensajes-api-whatsapp\/\">l\u00edmite de mensajes de la API de WhatsApp<\/a> detalla c\u00f3mo subir de nivel, y <a href=\"https:\/\/vectalk.com.br\/blog\/es\/limite-mensajes-por-segundo-api-whatsapp\/\">mensajes por segundo y rate limit<\/a> cubre el error <code>130429<\/code>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">El marketing pasa a la Marketing Messages API<\/h2>\n\n\n\n<p>Meta anunci\u00f3 que la Cloud API dejar\u00e1 de admitir mensajes de marketing el 13\/10\/2027, y que las cuentas de mensajes creadas a partir del 13\/04\/2027 ya no podr\u00e1n enviar marketing por la Cloud API (<a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/marketing-messages\/overview\" target=\"_blank\" rel=\"noreferrer noopener\">Marketing Messages API<\/a>). Despu\u00e9s de esa fecha, las plantillas de marketing se env\u00edan por la Marketing Messages API for WhatsApp. El ejemplo de abajo sigue usando la llamada de env\u00edo de la Cloud API, que funciona hoy; planifica la migraci\u00f3n antes del plazo con la gu\u00eda de la <a href=\"https:\/\/vectalk.com.br\/blog\/es\/marketing-messages-api-whatsapp-es\/\">Marketing Messages API<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Segmentaci\u00f3n: menos contactos, m\u00e1s resultado<\/h2>\n\n\n\n<p>El l\u00edmite por usuario tiene en cuenta la tasa de lectura reciente de la persona. En la pr\u00e1ctica, enviar a quien no lee empeora la entrega para todos. Segmentar bien es la forma m\u00e1s directa de mejorar el resultado:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Recencia.<\/strong> Prioriza a quien compr\u00f3, respondi\u00f3 o abri\u00f3 un mensaje en los \u00faltimos meses.<\/li>\n\n\n<li><strong>Inter\u00e9s declarado.<\/strong> Usa la categor\u00eda elegida en el opt-in. Quien acept\u00f3 &#8220;pedidos&#8221; no acept\u00f3 &#8220;ofertas&#8221;.<\/li>\n\n\n<li><strong>Historial de fallas.<\/strong> Saca los contactos con <code>131050<\/code> y reduce la frecuencia para quien acumula <code>131049<\/code>.<\/li>\n\n\n<li><strong>Frecuencia.<\/strong> Define en tu propio sistema un tope de campa\u00f1as por contacto por semana.<\/li>\n\n\n<li><strong>Personalizaci\u00f3n.<\/strong> Variables con el nombre, el \u00faltimo producto o la ciudad hacen que el mensaje sea esperado. Meta incluye los mensajes personalizados y \u00fatiles entre sus buenas pr\u00e1cticas de calidad.<\/li>\n\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Cu\u00e1nto cuesta un env\u00edo masivo<\/h2>\n\n\n\n<p>Desde el 1\/07\/2025, Meta cobra por mensaje entregado y no por conversaci\u00f3n. Para destinatarios en Brasil, la tarifa de marketing vigente desde el 1\/10\/2026 es de R$ 0,3217 por mensaje, y el marketing no tiene descuento por volumen (<a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/pricing\" target=\"_blank\" rel=\"noreferrer noopener\">p\u00e1gina de precios<\/a> y <a href=\"https:\/\/business.whatsapp.com\/products\/platform-pricing\" target=\"_blank\" rel=\"noreferrer noopener\">tabla en el sitio de WhatsApp Business<\/a>). Las tarifas cambian seg\u00fan el pa\u00eds del destinatario; para otros mercados, mira 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<figure class=\"wp-block-table\"><table><thead><tr><th>Tama\u00f1o de la campa\u00f1a<\/th><th>Costo estimado de Meta (Brasil, marketing)<\/th><\/tr><\/thead><tbody><tr><td>1.000 entregados<\/td><td>R$ 321,70<\/td><\/tr><tr><td>10.000 entregados<\/td><td>R$ 3.217,00<\/td><\/tr><tr><td>50.000 entregados<\/td><td>R$ 16.085,00<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Los mensajes no entregados no se cobran. Tampoco se cobran los mensajes dentro de la ventana de punto de entrada gratuito, que se abre cuando el cliente llega por un anuncio de clic a WhatsApp y dura hasta 7 d\u00edas. El art\u00edculo de <a href=\"https:\/\/vectalk.com.br\/blog\/es\/precio-api-whatsapp-brasil\/\">precio de la API de WhatsApp en Brasil<\/a> trae las dem\u00e1s categor\u00edas y el c\u00e1lculo a partir del webhook de estado, y <a href=\"https:\/\/vectalk.com.br\/blog\/es\/costo-campana-whatsapp\/\">cu\u00e1nto cuesta una campa\u00f1a de WhatsApp<\/a> muestra c\u00f3mo simular antes de enviar.<\/p>\n\n\n\n<p>Con Vectalk no registras tarjeta en Meta: cada mensaje entregado se descuenta de tu saldo prepago en Vectalk, y Vectalk le paga a Meta. Aseg\u00farate de que el saldo cubra la campa\u00f1a antes de empezar.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Por qu\u00e9 las listas compradas tumban el n\u00famero<\/h2>\n\n\n\n<p>Una lista comprada o &#8220;raspada&#8221; de grupos falla en el requisito m\u00e1s b\u00e1sico: esas personas nunca dieron opt-in a tu empresa. El efecto aparece en cadena:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Comentarios negativos.<\/strong> Meta calcula la calidad de los mensajes con base en los \u00faltimos siete d\u00edas, a partir de bloqueos, denuncias, silenciamientos, archivados y motivos informados al bloquear (<a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/messages\/send-messages\" target=\"_blank\" rel=\"noreferrer noopener\">calidad de los mensajes<\/a>).<\/li>\n\n\n<li><strong>Plantilla pausada.<\/strong> Con baja calidad, la plantilla entra en pausa y, a la tercera vez, se desactiva. La campa\u00f1a se corta a la mitad.<\/li>\n\n\n<li><strong>L\u00edmite congelado.<\/strong> El aumento autom\u00e1tico del l\u00edmite exige mensajes de alta calidad en todos los n\u00fameros y plantillas.<\/li>\n\n\n<li><strong>Restricciones en la cuenta.<\/strong> La pol\u00edtica prev\u00e9 restringir el acceso o limitar el env\u00edo de quien recibe muchos comentarios negativos. La <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/policy-enforcement\" target=\"_blank\" rel=\"noreferrer noopener\">documentaci\u00f3n de aplicaci\u00f3n de pol\u00edticas<\/a> describe bloqueos de 1 o 3 d\u00edas para plantillas, de 5, 7 o 30 d\u00edas para cualquier mensaje, un bloqueo de la cuenta por tiempo indefinido y, por \u00faltimo, la desactivaci\u00f3n permanente en la plataforma.<\/li>\n\n<\/ol>\n\n\n\n<p>Cambiar de n\u00famero no lo resuelve: el l\u00edmite y la reputaci\u00f3n quedan en el portafolio. El art\u00edculo sobre el <a href=\"https:\/\/vectalk.com.br\/blog\/es\/numero-bloqueado-api-whatsapp\/\">n\u00famero bloqueado en la API de WhatsApp<\/a> muestra c\u00f3mo diagnosticar y apelar, 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> explica por qu\u00e9 las herramientas no oficiales de env\u00edo masivo terminan en bloqueo.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Ejemplo: env\u00edo con ritmo controlado en Node.js<\/h2>\n\n\n\n<p>Vectalk no tiene una herramienta de env\u00edo masivo en el panel: la campa\u00f1a corre en tu sistema, que llama a la API una vez por destinatario. El script env\u00eda una plantilla de marketing por Vectalk a una lista ya filtrada por opt-in, con ritmo controlado y reintento ante el error de throughput. El payload es el mismo de la Cloud API.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code class=\"language-js\">const VECTALK = 'https:\/\/apis.vectalk.com.br\/api\/messages';\nconst TOKEN = process.env.VECTALK_TOKEN;\nconst POR_SEGUNDO = 20; \/\/ muy por debajo del tope por defecto de 80 mps\n\nconst pausa = (ms) =&gt; new Promise((r) =&gt; setTimeout(r, ms));\n\nasync function enviarPlantilla(contacto, intento = 1) {\n  const r = await fetch(VECTALK, {\n    method: 'POST',\n    headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application\/json' },\n    body: JSON.stringify({\n      messaging_product: 'whatsapp',\n      to: contacto.wa_id,\n      type: 'template',\n      template: {\n        name: 'oferta_semana',\n        language: { code: 'es' },\n        components: [\n          { type: 'body', parameters: [{ type: 'text', text: contacto.nombre }] },\n        ],\n      },\n    }),\n  });\n\n  const cuerpo = await r.json();\n  if (r.ok) return { wa_id: contacto.wa_id, wamid: cuerpo.messages[0].id };\n\n  const codigo = cuerpo.error?.code;\n  if (codigo === 130429 &amp;&amp; intento &lt;= 5) {\n    await pausa(1000 * 2 ** intento); \/\/ espera creciente\n    return enviarPlantilla(contacto, intento + 1);\n  }\n  return { wa_id: contacto.wa_id, error: codigo ?? r.status };\n}\n\nexport async function lanzarCampana(contactos) {\n  const resultados = [];\n  for (let i = 0; i &lt; contactos.length; i += POR_SEGUNDO) {\n    const lote = contactos.slice(i, i + POR_SEGUNDO);\n    resultados.push(...(await Promise.all(lote.map((c) =&gt; enviarPlantilla(c)))));\n    await pausa(1000);\n  }\n  return resultados; \/\/ guarda el wamid para cruzarlo despu\u00e9s con los estados\n}<\/code><\/pre>\n\n\n\n<p>La respuesta 200 de la API solo indica que el mensaje fue aceptado. La entrega, la lectura y las fallas como <code>131049<\/code> y <code>131050<\/code> llegan despu\u00e9s, en el webhook de estado:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code class=\"language-js\">export function manejarEstado(estado, db) {\n  if (estado.status !== 'failed') return db.actualizarEnvio(estado.id, estado.status);\n\n  const codigo = estado.errors?.[0]?.code;\n  if (codigo === 131050) db.marcarOptOut(estado.recipient_id, 'marketing');\n  if (codigo === 131049) db.programarNoAntesDe(estado.recipient_id, 24 * 60 * 60 * 1000);\n  db.actualizarEnvio(estado.id, 'failed', codigo);\n}<\/code><\/pre>\n\n\n\n<p>Si tu lista supera unos cientos de contactos, ejecuta el env\u00edo en un worker con cola persistente, para retomarlo donde qued\u00f3 si el proceso se cae.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Checklist antes de apretar &#8220;enviar&#8221;<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Plantilla de marketing aprobada, con bot\u00f3n de baja.<\/li>\n\n\n<li>Lista filtrada por opt-in de marketing y sin contactos dados de baja.<\/li>\n\n\n<li>Volumen de la campa\u00f1a dentro del l\u00edmite actual del portafolio.<\/li>\n\n\n<li>Ritmo de env\u00edo por debajo del throughput del n\u00famero.<\/li>\n\n\n<li>Webhook de estado registrando entregas, lecturas y fallas.<\/li>\n\n\n<li>Alguien siguiendo la calidad de la plantilla en las primeras horas.<\/li>\n\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Preguntas frecuentes<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">\u00bfPuedo enviar texto libre de forma masiva?<\/h3>\n\n\n\n<p>No. El texto libre solo se permite dentro de la ventana de 24 horas abierta por el cliente. Para iniciar el contacto con una lista, hace falta una plantilla. Mira la <a href=\"https:\/\/vectalk.com.br\/blog\/es\/ventana-24-horas-whatsapp\/\">ventana de 24 horas de WhatsApp<\/a>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\u00bfCon cu\u00e1ntos contactos puedo empezar?<\/h3>\n\n\n\n<p>Un portafolio nuevo llega a 250 destinatarios \u00fanicos en 24 horas fuera de la ventana de atenci\u00f3n. La verificaci\u00f3n de la empresa es uno de los caminos para llegar a 2.000. Despu\u00e9s, el l\u00edmite sube autom\u00e1ticamente con calidad y uso.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\u00bfSe cobra un mensaje con error 131049?<\/h3>\n\n\n\n<p>Meta solo cobra los mensajes entregados. Un mensaje con estado <code>failed<\/code> no se entrega y, por lo tanto, no se cobra.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\u00bfPuedo usar una plantilla de utilidad para una promoci\u00f3n, que es m\u00e1s barata?<\/h3>\n\n\n\n<p>No. Meta clasifica el contenido promocional como marketing y puede recategorizar la plantilla. A quien insiste le pueden convertir las plantillas de utilidad en marketing y bloquear la creaci\u00f3n de nuevas plantillas de utilidad por un tiempo.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\u00bfVale la pena tener varios n\u00fameros para enviar m\u00e1s?<\/h3>\n\n\n\n<p>No para el alcance. El l\u00edmite se calcula por portafolio y lo comparten todos los n\u00fameros. Varios n\u00fameros pueden tener sentido por organizaci\u00f3n (marcas, departamentos), no para esquivar el l\u00edmite.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Empieza con Vectalk<\/h2>\n\n\n\n<p>Vectalk te da acceso a la API oficial con los mismos payloads y webhooks de Meta y un token para todas las cuentas. Pagas una mensualidad y mantienes un saldo prepago; cada mensaje entregado se descuenta de ese saldo y Vectalk le paga a Meta, sin tarjeta registrada en Meta. Crea tu cuenta en <a href=\"https:\/\/apps.vectalk.com.br\/register\">apps.vectalk.com.br\/register<\/a> o habla con el equipo en la <a href=\"https:\/\/vectalk.com.br\/contato.html\">p\u00e1gina de contacto<\/a> para planificar tu integraci\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\/getting-opt-in\" target=\"_blank\" rel=\"noreferrer noopener\">Get opt-in for WhatsApp<\/a>, <a href=\"https:\/\/business.whatsapp.com\/policy\" target=\"_blank\" rel=\"noreferrer noopener\">Pol\u00edtica de Mensajes de WhatsApp Business<\/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\/templates\/marketing-templates\/per-user-limits\" target=\"_blank\" rel=\"noreferrer noopener\">L\u00edmites de marketing por usuario<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/templates\/marketing-templates\" target=\"_blank\" rel=\"noreferrer noopener\">Plantillas de marketing<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/marketing-messages\/overview\" target=\"_blank\" rel=\"noreferrer noopener\">Marketing Messages API: visi\u00f3n general<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/throughput\" target=\"_blank\" rel=\"noreferrer noopener\">Throughput<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/templates\/template-pausing\" target=\"_blank\" rel=\"noreferrer noopener\">Pausa de plantillas<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/policy-enforcement\" target=\"_blank\" rel=\"noreferrer noopener\">Aplicaci\u00f3n de pol\u00edticas<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/pricing\" target=\"_blank\" rel=\"noreferrer noopener\">Precios<\/a>, <a href=\"https:\/\/business.whatsapp.com\/products\/platform-pricing\" target=\"_blank\" rel=\"noreferrer noopener\">Tabla de precios en el sitio de WhatsApp Business<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Lo que exige Meta para enviar plantillas de marketing a escala por la API de WhatsApp: opt-in, los l\u00edmites que controlan el volumen, el costo y c\u00f3digo en Node.js con ritmo controlado.<\/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-716","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>Env\u00edo masivo por la API oficial de WhatsApp | Vectalk<\/title>\n<meta name=\"description\" content=\"Env\u00edo masivo por la API oficial de WhatsApp: opt-in, plantillas de marketing, l\u00edmites, segmentaci\u00f3n, costo y por qu\u00e9 las listas compradas tumban el n\u00famero.\" \/>\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\/envio-masivo-whatsapp-api-oficial\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Env\u00edo masivo por la API oficial de WhatsApp | Vectalk\" \/>\n<meta property=\"og:description\" content=\"Env\u00edo masivo por la API oficial de WhatsApp: opt-in, plantillas de marketing, l\u00edmites, segmentaci\u00f3n, costo y por qu\u00e9 las listas compradas tumban el n\u00famero.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vectalk.com.br\/blog\/es\/envio-masivo-whatsapp-api-oficial\/\" \/>\n<meta property=\"og:site_name\" content=\"Blog Vectalk\" \/>\n<meta property=\"article:published_time\" content=\"2026-10-29T13:17:33+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-10-29T13:18:11+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=\"12 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\\\/envio-masivo-whatsapp-api-oficial\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/es\\\/envio-masivo-whatsapp-api-oficial\\\/\"},\"author\":{\"name\":\"wanderleyfcunha\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#\\\/schema\\\/person\\\/ff36ecd9d8257856f227f8e5d639db2b\"},\"headline\":\"Env\u00edo masivo por la API oficial de WhatsApp: c\u00f3mo hacerlo sin perder el n\u00famero\",\"datePublished\":\"2026-10-29T13:17:33+00:00\",\"dateModified\":\"2026-10-29T13:18:11+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/es\\\/envio-masivo-whatsapp-api-oficial\\\/\"},\"wordCount\":2240,\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/es\\\/envio-masivo-whatsapp-api-oficial\\\/\",\"url\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/es\\\/envio-masivo-whatsapp-api-oficial\\\/\",\"name\":\"Env\u00edo masivo por la API oficial de WhatsApp | Vectalk\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#website\"},\"datePublished\":\"2026-10-29T13:17:33+00:00\",\"dateModified\":\"2026-10-29T13:18:11+00:00\",\"author\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#\\\/schema\\\/person\\\/ff36ecd9d8257856f227f8e5d639db2b\"},\"description\":\"Env\u00edo masivo por la API oficial de WhatsApp: opt-in, plantillas de marketing, l\u00edmites, segmentaci\u00f3n, costo y por qu\u00e9 las listas compradas tumban el n\u00famero.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/es\\\/envio-masivo-whatsapp-api-oficial\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/es\\\/envio-masivo-whatsapp-api-oficial\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/es\\\/envio-masivo-whatsapp-api-oficial\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Env\u00edo masivo por la API oficial de WhatsApp: c\u00f3mo hacerlo sin perder el n\u00famero\"}]},{\"@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":"Env\u00edo masivo por la API oficial de WhatsApp | Vectalk","description":"Env\u00edo masivo por la API oficial de WhatsApp: opt-in, plantillas de marketing, l\u00edmites, segmentaci\u00f3n, costo y por qu\u00e9 las listas compradas tumban el n\u00famero.","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\/envio-masivo-whatsapp-api-oficial\/","og_locale":"en_US","og_type":"article","og_title":"Env\u00edo masivo por la API oficial de WhatsApp | Vectalk","og_description":"Env\u00edo masivo por la API oficial de WhatsApp: opt-in, plantillas de marketing, l\u00edmites, segmentaci\u00f3n, costo y por qu\u00e9 las listas compradas tumban el n\u00famero.","og_url":"https:\/\/vectalk.com.br\/blog\/es\/envio-masivo-whatsapp-api-oficial\/","og_site_name":"Blog Vectalk","article_published_time":"2026-10-29T13:17:33+00:00","article_modified_time":"2026-10-29T13:18:11+00:00","author":"wanderleyfcunha","twitter_card":"summary_large_image","twitter_misc":{"Written by":"wanderleyfcunha","Est. reading time":"12 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/vectalk.com.br\/blog\/es\/envio-masivo-whatsapp-api-oficial\/#article","isPartOf":{"@id":"https:\/\/vectalk.com.br\/blog\/es\/envio-masivo-whatsapp-api-oficial\/"},"author":{"name":"wanderleyfcunha","@id":"https:\/\/vectalk.com.br\/blog\/#\/schema\/person\/ff36ecd9d8257856f227f8e5d639db2b"},"headline":"Env\u00edo masivo por la API oficial de WhatsApp: c\u00f3mo hacerlo sin perder el n\u00famero","datePublished":"2026-10-29T13:17:33+00:00","dateModified":"2026-10-29T13:18:11+00:00","mainEntityOfPage":{"@id":"https:\/\/vectalk.com.br\/blog\/es\/envio-masivo-whatsapp-api-oficial\/"},"wordCount":2240,"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/vectalk.com.br\/blog\/es\/envio-masivo-whatsapp-api-oficial\/","url":"https:\/\/vectalk.com.br\/blog\/es\/envio-masivo-whatsapp-api-oficial\/","name":"Env\u00edo masivo por la API oficial de WhatsApp | Vectalk","isPartOf":{"@id":"https:\/\/vectalk.com.br\/blog\/#website"},"datePublished":"2026-10-29T13:17:33+00:00","dateModified":"2026-10-29T13:18:11+00:00","author":{"@id":"https:\/\/vectalk.com.br\/blog\/#\/schema\/person\/ff36ecd9d8257856f227f8e5d639db2b"},"description":"Env\u00edo masivo por la API oficial de WhatsApp: opt-in, plantillas de marketing, l\u00edmites, segmentaci\u00f3n, costo y por qu\u00e9 las listas compradas tumban el n\u00famero.","breadcrumb":{"@id":"https:\/\/vectalk.com.br\/blog\/es\/envio-masivo-whatsapp-api-oficial\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vectalk.com.br\/blog\/es\/envio-masivo-whatsapp-api-oficial\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/vectalk.com.br\/blog\/es\/envio-masivo-whatsapp-api-oficial\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vectalk.com.br\/blog\/"},{"@type":"ListItem","position":2,"name":"Env\u00edo masivo por la API oficial de WhatsApp: c\u00f3mo hacerlo sin perder el n\u00famero"}]},{"@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\/716","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=716"}],"version-history":[{"count":1,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/posts\/716\/revisions"}],"predecessor-version":[{"id":718,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/posts\/716\/revisions\/718"}],"wp:attachment":[{"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/media?parent=716"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/categories?post=716"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/tags?post=716"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}