Los cinco canales, en dos líneas cada uno
Meta Cloud API (Oficial)
La API de Meta, con número verificado y cuenta de empresa. Es el canal que acepta más cosas: el
único con formularios, catálogo y plantillas. A cambio, tiene la ventana de 24
horas.
WhatsApp Web
La conexión por código QR, con el teléfono emparejado. Sin ventana y sin plantilla: escribes a
cualquier hora. Algunas funciones de tienda exigen que el número sea una cuenta WhatsApp Business
con productos registrados.
Instagram y Messenger
Conversación de mensajes directos. Aceptan texto, multimedia y botones, y ahí paran: sin ubicación,
sin contacto, sin lista de opciones. Los dos tienen ventana de 24 horas.
Telegram
Un bot. Acepta casi todo y no tiene ventana, pero habla otro idioma: lo que en WhatsApp es un tipo
de mensaje, allí a veces es un botón de teclado.
Cómo leer la tabla
⚠️ nunca significa “quizá funcione”. Significa que funciona y sabemos bajo qué condición — y la
condición está explicada aquí abajo, y también en la página de cada endpoint, debajo de su tabla.
El día a día de la conversación
Texto y multimedia son el terreno común: funcionan en los cinco, con el mismo cuerpo. Es de ahí para
arriba que los canales empiezan a discrepar.
Cuando el cliente responde con un toque
El botón rápido es el que vuelve como respuesta del cliente, y existe en todos los canales. El botón de
acción es el que ejecuta el dispositivo: abrir un enlace o llamar. El enlace funciona en todos;
llamar, solo donde la plataforma tiene botón de teléfono.
Tienda y pedidos
El mensaje de tienda depende de que exista una tienda. En WhatsApp el catálogo vive en la cuenta de
empresa; en Instagram y Messenger la API de mensajes no alcanza el catálogo; en Telegram no hay
catálogo, y lo que existe es el cobro puntual.
Plantilla preaprobada
La plantilla es el mensaje que Meta aprueba antes para que puedas escribir primero, fuera de la
ventana. Solo existe donde hay ventana: Meta Cloud API y Messenger. En los otros canales escribes
cuando quieras, así que no haría falta.
Las reservas, una por una
Sticker en Instagram y Messenger
En los dos no envías tu archivo. Instagram acepta solo el sticker de corazón; Messenger acepta solo los stickers públicos del catálogo de Meta, elegidos por identificador, y el pulgar arriba. Un.webp hecho por tu equipo pasa en WhatsApp y en Telegram, y es rechazado en esos dos.
Qué hacer: en esos canales, envía la misma imagen como foto. El cliente ve la figura; solo que no
viene con fondo transparente.
Fuente: Sticker API de Messenger.
Botón de acción en Instagram y Telegram
El botón de acción es el par “abrir enlace” y “llamar”. En esos dos, solo funciona el enlace: la plantilla de botones de Instagram acepta solo enlace y respuesta, y el teclado de Telegram no tiene botón de teléfono. Qué hacer: cambia el botón de llamar por un botón de enlace contel: como destino cuando el canal
lo permita, o escribe el teléfono en el texto del mensaje.
Catálogo, producto y pedido en WhatsApp Web
Funcionan, pero por otro camino: pasan por la compatibilidad con Z-API y solo salen si el número conectado es una cuenta WhatsApp Business con productos registrados. Un número personal no tiene catálogo, así que no hay nada que enviar. Qué hacer: si la tienda es la parte importante de tu integración, usa Meta Cloud API. En Web, trata el catálogo como un extra que depende de cómo el cliente configuró su número. Fuentes: producto, catálogo y pedido en Z-API.Multiproducto solo en la plataforma oficial
Enviar varios productos en un mensaje solo existe en Meta Cloud API. En la conexión no oficial puedes enviar un producto por vez, y en los otros canales no hay equivalente.Detalles del pedido en Messenger y Telegram
Los dos tienen algo parecido, y la diferencia importa:- Messenger: el comprobante de pedido muestra artículos, total y forma de pago, pero es el registro de una compra ya hecha. No tiene botón de pagar.
- Telegram: la factura cobra dentro de la app, y para eso exige un proveedor de pago configurado en el bot.
Pedir ubicación en Telegram
Funciona, solo que no es un tipo de mensaje: es un botón de teclado que pide la ubicación (request_location). Para el cliente da
igual, toca y la ubicación llega. Lo marcamos ✅ porque el resultado es el mismo.
Reacción en Messenger
Aquí la respuesta honesta es: no lo sabemos. La reacción que manda el cliente sí te llega por el webhook, pero no encontramos en la documentación de Meta la confirmación de que la empresa pueda reaccionar a un mensaje. El changelog lo menciona, la referencia del endpoint no describe el campo. En Instagram, la reacción está documentada y funciona. Qué hacer: no construyas un flujo que dependa de reaccionar en Messenger sin probarlo antes. Cuando lo confirmemos, esta página cambia.Plantilla en Instagram
No es una decisión de Meta, es consecuencia de cómo conectamos: la edgemessage_templates del Graph
API existe solo en el node Page, y Omni Z-API conecta Instagram mediante Instagram Login, que no
expone esa edge. Más detalles en Conectar Instagram.
Cuando el canal no lo acepta: qué enviar en su lugar
La ventana de 24 horas, en una frase
El content.type de cada recurso
Algunos de estos endpoints todavía están en desarrollo. La página de cada uno avisa arriba, y el
playground muestra cuáles ya responden de verdad.
Próximos pasos
Enviar el primer mensaje
El cuerpo mínimo, y lo que vuelve.
Ventana de conversación
Cuándo puedes escribir primero, y cuándo necesitas plantilla.
Ciclo de vida del canal
Crear, conectar, suscribir, desconectar y eliminar.
Limitaciones de la API Oficial
Lo que tiene la Z-API clásica y la oficial no.