Saltar al contenido

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.

Pantalla de InvestCRM: el panel en portugués, con Público alvo todavía sin condición y ya con el conteo en vivo (64 contactos recibirán la difusión); en la lista Pronto para transmitir solo el ítem del público está marcado, la casilla Confirmo o opt-in sigue vacía y el menú + Condição abierto muestra Tag, Segmento, Sequência de assinatura y Origem do opt-in
Pantalla real de InvestCRM, con datos de ejemplo.

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.

Pantalla de InvestCRM: automatización con disparador por palabras (orçamento, preço, quanto custa), armada en el mismo constructor de flujos de las difusiones; los tres botones del mensaje llevan a Atendimento com IA, a Ações con la etiqueta Quer orçamento y el embudo y a una Condição por la etiqueta Cliente VIP con un Atraso Inteligente de 10 minutos
Pantalla real de InvestCRM, con datos de ejemplo.

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úmeroQué cuenta
EnviadosMensajes que salieron, de cuántos destinatarios en total.
EntregadosMensajes que llegaron al teléfono, en porcentaje de los enviados.
LeídosMensajes abiertos, en porcentaje de los enviados.
RespuestasQuién respondió a la difusión.
FallosMensajes que no salieron o que Meta devolvió con error.
OmitidosQuien 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.

Cuenta de ejemplo con la tabla oficial de Meta, número de Brasil
Para quéCobrados × precio por mensajeCosto en el mes
Campaña de novedades para quien pidió ofertas · Marketing2.000 × R$ 0,3217R$ 643,40
Avisos de pedido y de vencimiento · Utilidad3.000 × R$ 0,0350R$ 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
TotalR$ 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.

Planes de InvestCRM: precio, límites y funciones de cada uno
FunciónGrátisStartBusinessEnterprise
Precio por mesR$ 0R$ 147R$ 297R$ 597
Mensajes de difusión al mesNo incluido1.000Sin límiteSin límite
Ritmo de envío de las difusionesNo incluidoHasta 600 por minutoHasta 600 por minutoHasta 600 por minuto
Programar difusión por día y horaNo incluidoIncluidoIncluidoIncluido
Envío Avanzado, por lotesNo incluidoNo incluidoIncluidoIncluido
Contactos incluidos1001.0005.000Sin límite
Personas en la cuentaSolo túTú y 1 másTú y 3 másTú y 15 más

Ver todos los planes y precios →

Sigue leyendo

Para armar tu primera difusión

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.