Disparo API
Difusiones por la API Oficial de WhatsApp: qué pasa en cada etapa
En InvestCRM, un envío por la API Oficial de WhatsApp es una difusión: una plantilla aprobada por Meta va al público que eliges, al ritmo que defines, y cada envío queda registrado con su resultado. Abajo están las reglas de cada etapa, desde el texto de la plantilla hasta el motivo de un fallo.
Antes de enviar
Lo que pesa en una difusión por la API Oficial
En la API Oficial, Meta cobra por mensaje entregado, según la categoría de la plantilla y el país del número de quien recibe. Para quien recibe en un número de Brasil, marketing cuesta R$ 0,3217 por mensaje y utilidad, R$ 0,0350: 9,2 veces menos. La categoría que eliges para la plantilla cambia la cuenta de todo el mes.
La reacción de quien recibe también cuenta. Según la política de Meta, los bloqueos y las denuncias pueden hacer que Meta limite cuántos mensajes envía el número. Y quien pidió salir tiene que quedar fuera de todas las difusiones siguientes, no solo de la actual.
- Categoría: InvestCRM muestra la categoría que Meta aprobó, y no la que pediste.
- Público: una condición de inclusión, líneas de exclusión y la lista de bloqueo fuera en cada envío.
- Ritmo: de 1 a 600 envíos por minuto, con un aviso cuando una difusión pasa de 100 en el mismo día.
- Resultado: enviados, entregados, leídos, respuestas, fallos, omitidos y el motivo de cada fallo.
La plantilla
Cómo armar la plantilla que va a aprobación
Toda difusión empieza con una plantilla de mensaje aprobada por Meta. Se crea en Plantillas, o dentro de la propia difusión en "O crea una plantilla nueva", y va a aprobación cuando la guardas. La aprobación suele tardar minutos y puede llegar a 24 horas.
- Nombre: solo minúsculas, números y guion bajo. Si escribes "Boas Vindas", el editor muestra que se guardará como boas_vindas y lo guarda así.
- Categoría: Marketing (ofertas, novedades) o Utilidad (avisos, confirmaciones). La lista también trae Autenticación (códigos), que no sirve para difusiones (mira la nota más abajo).
- Encabezado (opcional): texto de hasta 60 caracteres, imagen, video o PDF. El archivo va directo a los servidores de Meta, que lo usa como ejemplo en la aprobación.
- Cuerpo: hasta 1.024 caracteres. Los datos del contacto entran por su nombre (Primer nombre, Nombre completo, Teléfono, Campo 1…) y el editor los convierte en {{1}}, {{2}}, el formato que pide Meta.
- Pie (opcional): hasta 60 caracteres. El propio editor sugiere usarlo para indicar cómo dejar de recibir mensajes.
- Botones (opcionales): hasta 3 de respuesta rápida, hasta 2 de enlace y 1 de llamada, cada uno con hasta 25 caracteres.
Tras el envío, la plantilla aparece como Aprobada, En revisión, Rechazada o Pausada. InvestCRM recibe el aviso de Meta y, como red de seguridad, revisa cada 5 minutos las plantillas que siguen en revisión: nadie necesita hacer clic en "sincronizar".
Categorías
Marketing, utilidad o autenticación: cómo decide Meta
Meta revisa la categoría por el contenido. Para ser utilidad, la plantilla no puede tener intención de venta y tiene que tratar algo de la propia persona (un pedido, una cuenta, un servicio contratado) o ser esencial para ella. Una plantilla que mezcla aviso y oferta es marketing. El carrito abandonado y la renovación de una suscripción también son marketing, aunque la persona lo haya pedido. Fuente: categorías de plantilla, en la documentación de Meta
Cuando Meta concluye que una plantilla de utilidad debería ser marketing, cambia la categoría con un día de aviso; la plantilla sigue aprobada, pero con el precio de marketing. Quien insiste en clasificar marketing como utilidad puede tener los envíos de utilidad limitados durante al menos 7 días. En InvestCRM, la tabla Meus Modelos, en Configuración → WhatsApp, muestra la categoría real y, cuando cambia, avisa debajo de ella que Meta la cambió.
Cuatro plantillas de ejemplo, con la categoría probable y el porqué:
Aviso de pedido enviado
Nombre en Meta: aviso_envio_pedido · Categoría: Utilidad
Por qué esta categoría: Habla de un pedido que la persona hizo, trae su número y no sugiere ninguna compra. Meta pone este caso (gestión de pedidos) como ejemplo de utilidad.
Recordatorio de vencimiento
Nombre en Meta: lembrete_vencimento · Categoría: Utilidad
Por qué esta categoría: Recordar el pago de un servicio que la persona ya contrató es una alerta de cuenta, que Meta trata como utilidad. Basta una invitación a renovar o comprar más para que pase a marketing.
Novedad para quien pidió ofertas
Nombre en Meta: novidade_colecao · Categoría: Marketing
Por qué esta categoría: Divulga productos para vender: es marketing aunque la persona ya sea cliente. El texto ya dice cómo dejar de recibir, con una palabra que InvestCRM reconoce cuando se escribe.
Carrito guardado
Nombre en Meta: carrinho_guardado · Categoría: Marketing
Por qué esta categoría: Parece un aviso, pero Meta clasifica el carrito abandonado y la renovación como marketing, aunque la persona lo haya pedido, porque el objetivo es vender. Pedirlo como utilidad solo hace que Meta cambie la categoría.
Más textos listos, separados por categoría, en Plantillas de mensaje.
Público
Quién recibe: una condición, las exclusiones y lo que siempre queda fuera
El Público objetivo acepta una condición de inclusión; sin ninguna, la difusión va a todos los contactos de la cuenta, menos la lista de bloqueo. En + Condición, los Filtros Generales son Etiqueta (es o no es), Segmento, Secuencia de suscripción y Origen del opt-in (Importación, Escribió por WhatsApp o Registro manual). Los Campos del sistema son Nombre Completo y Teléfono (contiene) y Suscrito (tiene opt-in confirmado).
Debajo, el botón discreto + Excluir público agrega líneas de Etiqueta "no es", que quitan contactos por encima de la condición. El público acepta hasta 20 líneas en total, y el conteo de quién va a recibir cambia con cada ajuste.
- Quien está en la lista de bloqueo nunca entra, en las dos grafías del noveno dígito de Brasil.
- Una condición a medias (etiqueta sin elegir, segmento borrado) no se vuelve "todo el mundo": el público queda vacío y la pantalla dice qué falta.
- Un número que es la conexión de otra cuenta tuya queda fuera: una cuenta nunca envía a la otra.
- El contacto que recibe la etiqueta "descadastro" pasa solo a la lista de bloqueo.
La lista Listo para difundir pide número de WhatsApp elegido, plantilla aprobada, botones de la plantilla conectados en el flujo (cuando hay botones), público con al menos 1 contacto y la casilla Confirmo el opt-in, en la que declaras que esos contactos autorizaron recibir mensajes de tu empresa. Sin esa confirmación, el servidor rechaza la publicación.

Fecha y ritmo
Ahora o con fecha, al ritmo que el número soporta
Enviar ahora dispara en cuanto confirmas. El reloj de al lado abre Programar Difusión, con calendario y horario propios; la pantalla avisa que vale la zona horaria America/Sao_Paulo (hora de Brasilia).
En la confirmación, el Ritmo de envío ofrece tres ritmos listos, Lento (6 por minuto), Estándar (20) y Rápido (60), y el Personalizado, en el que indicas cuántos envíos cada tantos segundos, minutos u horas. El resultado siempre queda entre 1 y 600 por minuto, y la pantalla muestra cuánto tarda el envío y a qué hora termina.
Por encima del ritmo de InvestCRM está el techo de Meta. Cuenta a cuántas personas distintas les llegan mensajes de la empresa fuera de la ventana de atención en un período móvil de 24 horas, pertenece a todo el portafolio (todos sus números suman juntos) y empieza en 250 en un portafolio nuevo. El escalón actual aparece en Configuración → WhatsApp, en Límites de mensajes; mientras sea bajo, un público grande tiene que salir repartido en días. Meta también puede dejar de entregar un marketing a una persona concreta para mantener un engagement sano (error 131049): su orientación es esperar al menos 24 horas antes de reenviarlo. Fuente: límites de mensajes de Meta · Fuente: códigos de error de Meta · Límite del portafolio y avisos de Meta · Calidad del número y límite de envío
Envío Avanzado: el público en lotes
En la pestaña Envío Avanzado, desde el plan Business, defines cuántos contactos van en cada lote y cada cuántos días sale uno: 1, 2, 3 o 7. Son de 2 a 30 lotes, con la fecha de cada uno editable. El público se congela al programar y se reparte sin repetir a nadie; cada lote se vuelve una difusión propia en la lista, llamada "Nombre — Lote 1/N", con sus métricas.
En el plan Start, que tiene 1.000 mensajes de difusión al mes y no tiene lotes, el servidor rechaza la difusión entera cuando el público supera lo que queda del mes, y nada sale a medias. En un envío para el mes en curso, la pantalla ya avisa antes de publicar.
Después de la plantilla
Cada botón de la plantilla abre un camino
Ir al Constructor de Flujos abre el tablero de la difusión, con la plantilla como primer bloque. Si la plantilla tiene botones, cada uno debe estar conectado a un paso siguiente; si no, la lista no libera el envío, para que nadie toque un botón que no responde. La imagen de esta sección es de una automatización, que empieza por un disparador; en la difusión, el mismo constructor empieza por la plantilla.
Los pasos disponibles son los mismos de las automatizaciones: Enviar Mensaje, Acciones (etiqueta, campo, embudo, secuencia, pasar al equipo), Condición, Retraso Inteligente, Atención con IA, Aleatorizador, Iniciar la automatización y Baja.
¿Ya tienes un flujo listo? Difusión a partir de una automatización crea la difusión con el flujo de una automatización existente. Mira cómo funcionan las automatizaciones.

Durante el envío
Lo que el sistema revisa mientras sale la difusión
El motor de envío trabaja en rondas de 15 segundos y manda, en cada una, la parte que corresponde al ritmo elegido. Antes de cada ronda revisa de nuevo quién puede recibir:
- Quien escribió SAIR, PARAR, STOP, CANCELAR o DESCADASTRAR después de la programación queda omitido, con el motivo "pidió la baja antes del envío".
- Quien está esperando a un agente o hablando con alguien del equipo no recibe la difusión encima de la conversación: el envío para esa persona espera.
- Si Meta rechaza por pago (error 131042), las difusiones de ese número se pausan y se avisa al dueño de la cuenta. Cuando una vuelve a correr, sale 1 mensaje por vez, cada 10 minutos, en lugar del lote: es la forma de saber si Meta volvió a aceptar el pago.
- Si la conexión con Meta venció o fue revocada, el envío se detiene en lugar de marcar toda la lista como fallo.
- Si el enlace del archivo del encabezado venció, el sistema vuelve a buscarlo en Meta antes de enviar.
- Un envío que se cayó a la mitad y no se confirmó en 10 minutos queda como fallo, con el aviso de que no se reenvió para no llegar duplicado.
Mientras la difusión sale, puedes Pausar, Reanudar y Cancelar. Al reanudar con más de 100 mensajes todavía en la fila, el aviso del volumen diario vuelve a aparecer. Qué hacer cuando Meta rechaza la tarjeta.
Informe
El informe: qué significa cada número
En la lista de Difusiones, el Historial muestra cada envío con Inicio del envío, Enviado, Entregado (%), Leído (%) y Clic (%). Al abrir una difusión ya enviada, el cuadro Métricas trae:
| Número | Qué cuenta |
|---|---|
| Enviados | Mensajes que salieron, de cuántos destinatarios en total. |
| Entregados | Mensajes que llegaron al teléfono, en porcentaje de los enviados. |
| Leídos | Mensajes abiertos, en porcentaje de los enviados. |
| Respuestas | Quién respondió a la difusión. |
| Fallos | Mensajes que no salieron o que Meta devolvió con error. |
| Omitidos | Quien pidió la baja después de la programación o no abrió la ventana de 24 horas para un paso libre. |
Abajo vienen Por qué falló, con los 10 fallos más recientes (el contacto y el motivo), y Clics por botón (CTR), con clics, envíos y la tasa de cada botón. En el tablero del flujo, el número encima de cada bloque (Enviado, Entregado, Clic) abre la lista de contactos detrás de él.
El informe cuenta lo que pasó con cada envío; la cuenta en dinero es de Meta, por mensaje entregado, en la tarjeta registrada en la cuenta de WhatsApp. Para estimar el valor antes de enviar, usa la calculadora de costos, que sigue la tabla oficial.
Motivos que escribe el propio InvestCRM
- El contacto pidió la baja (SAIR) antes del envío: entra como omitido, no como fallo.
- El número es de tu propio sistema (conexión de otra cuenta) y no recibe envíos.
- La plantilla tiene encabezado con archivo, pero el archivo no se encontró: vuelve a crear la plantilla subiendo el archivo por el editor.
- Caída a mitad del envío, sin confirmación: no se reenvió para evitar un mensaje duplicado.
Los demás motivos traen el error que devolvió Meta. La guía de la API Oficial explica los códigos más comunes y qué hacer en cada uno.
Una difusión enviada queda como versión publicada: para enviarla otra vez, Duplicar crea un borrador igual. Copiar a otra cuenta lleva el flujo a otra cuenta tuya como borrador; el número, la plantilla y el público los eliges allí.
Costo
Un mes de difusiones en la cuenta de Meta
Ejemplo de una tienda que, en el mes, envía 5.000 plantillas (avisos de pedido y de vencimiento y una campaña de novedades) y responde a quien escribe de vuelta. InvestCRM no cobra por mensaje: Meta cobra directo en la tarjeta registrada en la cuenta de WhatsApp, sin sobreprecio.
| Para qué | Cobrados × precio por mensaje | Costo en el mes |
|---|---|---|
| Campaña de novedades para quien pidió ofertas · Marketing | 2.000 × R$ 0,3217 | R$ 643,40 |
| Avisos de pedido y de vencimiento · Utilidad | 3.000 × R$ 0,0350 | R$ 105,00 |
| Respuestas a quien escribió de vuelta · Servicio (atención) | 1.500 × R$ 0,0350 (de 2.500 en el mes) | R$ 52,50 |
| Total | R$ 800,90 |
Total estimado en el mes, pagado directo a Meta: R$ 800,90. Los primeros 1.000 mensajes de servicio de cada número, cada mes, son gratis. Si las plantillas de utilidad de esta cuenta se clasificaran como marketing, el mismo mes pasaría de R$ 800,90 a R$ 1.661,00. Los volúmenes son un ejemplo para mostrar la cuenta, no datos de un cliente.
Tabla de Meta en reales para números de Brasil, vigente desde el 1 oct 2026, revisada el 9 oct 2026. Ver la tabla en Meta · Haz tu cuenta en la calculadora
Desde el 01/10/2026 la respuesta común dentro de la ventana de 24 horas también se cobra, como servicio, con 1.000 por número sin costo cada mes. El artículo Cuánto cuesta la API Oficial de WhatsApp explica la tabla completa.
Reglas
Las reglas de Meta y de la LGPD, y qué hace InvestCRM con cada una
Opt-in antes del primer mensaje
La política de WhatsApp Business solo permite contactar a quien dio su número y autorizó recibir mensajes de la empresa; la forma de obtener esa autorización es responsabilidad de la empresa. Fuente: política de mensajería de WhatsApp Business
En InvestCRM: publicar exige marcar Confirmo el opt-in, y el público se puede filtrar por Suscrito o por el Origen del opt-in. El sistema no revisa cómo se obtuvo el opt-in: eso sigue siendo tuyo.
Quien pide salir, sale
La política exige respetar el pedido de dejar de recibir, hecho dentro o fuera de WhatsApp, y la ley brasileña de datos (LGPD) dice que el consentimiento puede revocarse en cualquier momento, por un procedimiento gratuito y sencillo (art. 8, § 5). Fuente: política de WhatsApp Business · Fuente: Ley 13.709/2018
En InvestCRM: quien escribe solo SAIR, PARAR, STOP, CANCELAR o DESCADASTRAR pasa a la lista de bloqueo. Tocar un botón con esas palabras no cuenta, porque el botón es un camino del flujo. El pedido hecho por teléfono o correo lo registras en la lista de bloqueo, desde la pantalla Contactos.
La conversación empieza con una plantilla aprobada
Fuera de la ventana de 24 horas, que se abre y se renueva con cada mensaje de la persona, la empresa solo puede escribir con una plantilla aprobada. Fuente: política de WhatsApp Business
En InvestCRM: el primer bloque de la difusión es siempre la plantilla; los pasos libres posteriores solo salen para quien respondió.
Bloqueos y denuncias reducen el alcance
Meta puede limitar cuántos mensajes envía la empresa según los bloqueos y denuncias de quienes reciben. Fuente: política de WhatsApp Business
En InvestCRM: el aviso de difusión por encima de 100 por día y la lista de bloqueo fuera de cada envío ayudan, pero ningún sistema puede prometer que un número nunca será limitado. La guía de buenas prácticas de envío muestra lo que más pesa.
Los datos sensibles quedan fuera de la conversación
La política prohíbe pedir o compartir el número completo de tarjeta, de cuenta bancaria o de documento de identidad. Fuente: política de WhatsApp Business
En InvestCRM: el texto de la plantilla es tuyo y el sistema no lo lee ni lo bloquea. Usa los campos del contacto solo para lo que el mensaje necesita.
Planes
Difusiones en cada plan
El plan Grátis no tiene difusiones. Start envía hasta 1.000 mensajes de difusión al mes, con programación y ritmo de hasta 600 por minuto. Business y Enterprise no tienen límite mensual de mensajes de difusión en InvestCRM (el techo de 24 horas de Meta sigue valiendo) y liberan el Envío Avanzado por lotes; la cuenta de ejemplo de arriba, con 5.000 plantillas en el mes, ya pide Business.
En el equipo, armar y enviar difusiones es tarea del Editor, del Administrador y del Propietario; el Colaborador y el Lector solo acompañan.
| Función | Grátis | Start | Business | Enterprise |
|---|---|---|---|---|
| Precio por mes | R$ 0 | R$ 147 | R$ 297 | R$ 597 |
| Mensajes de difusión al mes | No incluido | 1.000 | Sin límite | Sin límite |
| Ritmo de envío de las difusiones | No incluido | Hasta 600 por minuto | Hasta 600 por minuto | Hasta 600 por minuto |
| Programar difusión por día y hora | No incluido | Incluido | Incluido | Incluido |
| Envío Avanzado, por lotes | No incluido | No incluido | Incluido | Incluido |
| Contactos incluidos | 100 | 1.000 | 5.000 | Sin límite |
| Personas en la cuenta | Solo tú | Tú y 1 más | Tú y 3 más | Tú y 15 más |
Sigue leyendo
Para armar tu primera difusión
- Automatización de atención en WhatsApp
- Integraciones y API de InvestCRM
- Atención con IA para quien responde
- CRM y embudo de ventas
- Conversiones Meta y Google
- Precios y planes
- Plantillas de mensaje listas
- Buenas prácticas de envío en WhatsApp
- Guía de la API Oficial de WhatsApp
- Cuánto cuesta la API Oficial de WhatsApp
- Calculadora de costos de Meta
- Página de inicio de InvestCRM
Empieza gratis en InvestCRM
El plan Gratis no tiene plazo ni pide tarjeta. Conecta tu número por la ventana de Meta y conoce el sistema.