WhatsApp API

En Yolani esta vía se llama WhatsApp API y vive en Canales, dentro de la sección WhatsApp, junto a WhatsApp Web (QR).

Es la conexión oficial de Meta. No depende de un teléfono vinculado, aguanta volumen alto y es la única que permite escribirle a un cliente fuera de la ventana de 24 horas con plantillas aprobadas.

Cuándo te conviene

Sí, si:

• No puedes permitirte que el canal se caiga porque un teléfono se quedó sin batería.

• Mandas notificaciones proactivas: confirmaciones, recordatorios, avisos de pedido.

• Tu volumen es alto y con QR ya te preocupa que WhatsApp te limite el número.

• Quieres plantillas aprobadas por Meta.

• Tu número está en la app de WhatsApp Business y no quieres soltarlo: con coexistence lo conservas, junto con la app.

Puede esperar, si:

• Solo quieres probar Yolani en dos minutos, o tu número es de WhatsApp normal (no Business). Para eso está WhatsApp Web (QR).

Las tres formas de conectarla

Cuando no tienes ningún WhatsApp conectado, Canales te muestra dos tarjetas comparativas: WhatsApp API (etiqueta API, primero y marcada como Recomendado) y WhatsApp Web (etiqueta QR). Si en tu cuenta no está disponible el modo coexistence, el orden se invierte y el sello pasa a WhatsApp Web.

En la tarjeta de WhatsApp API puedes ver hasta tres accesos, según lo que tenga habilitado tu cuenta:

Los dos primeros abren el Embedded Signup de Meta: inicias sesión con tu cuenta de Facebook Business y autorizas desde ahí. No tienes que copiar tokens.

Conectar con Meta (recomendado)

Conectar con credenciales manuales

Si prefieres (o si tu cuenta no tiene disponible el flujo de Meta), el botón Configurar credenciales abre un formulario con tres campos:

En ese mismo modal, Yolani te muestra el Callback URL y el Verify Token que debes pegar en la configuración de webhooks de tu app de Meta. Cada uno tiene su botón de copiar.

Estados de la fila WhatsApp API

Cuando está conectada, la fila muestra el Número, el WABA ID y el Webhook por empresa, además de los botones Probar conexión, Actualizar credenciales y Desconectar.

Si conectaste coexistence: la sincronización

Los primeros minutos verás un aviso con el avance de la sincronización de contactos e historial. Los estados posibles son:

Tener las dos vías conectadas a la vez

Sí se puede, y son dos números distintos. Cuando ambos están activos, Yolani te muestra un aviso explicando la regla, que es la siguiente:

• Cada conversación se responde por el número al que te escribió el cliente. Nadie recibe respuestas desde un número que no conoce.
• Los mensajes a contactos nuevos, sin conversación previa, salen por WhatsApp Web.

El permiso de Meta caduca

Los tokens de Meta tienen vencimiento. Yolani los renueva sola alrededor de los 30 días, así que en el caso normal nunca ves nada.

Si aparece un aviso amarillo o rojo diciendo que "el permiso de Meta caduca" o "caducó", significa una de dos cosas: la renovación automática lleva fallando el tiempo suficiente para consumirse el margen, o el token ya murió. Meta no resucita tokens muertos.

La acción correcta es el botón Reconectar con Meta (o Renovar con Meta), que relanza el flujo de Meta en un clic. Actualizar credenciales está ahí para quien conectó pegando el token a mano.

Plantillas y la ventana de 24 horas

Con la API oficial aplica la regla de Meta: puedes escribir libremente durante 24 horas desde el último mensaje del cliente. Pasado ese plazo, para retomar la conversación necesitas una plantilla aprobada.

Cuando conectas WhatsApp API, en el menú lateral aparece la sección Plantillas. Ver Plantillas de WhatsApp.

Costos

Son dos cosas separadas y conviene no confundirlas:

Yolani no cobra comisión sobre lo que te cobre Meta.

Qué cobra Meta

Meta cobra por mensaje entregado, no por conversación:

• Plantillas: cada una que se entrega, con un precio según su categoría (marketing, utilidad, autenticación) y el país del cliente.
• Respuestas (lo que tú o tu agente contestan dentro de las 24 horas): desde el 1 de octubre de 2026 también se cobran, pero cada número tiene 1,000 gratis al mes. A partir de la 1,001 se cobran a la tarifa de utilidad del país. Desde esa misma fecha, las plantillas de utilidad que mandas dentro de las 24 horas también se cobran.
• Anuncios de clic a WhatsApp: si el cliente te escribió desde uno de esos anuncios, los mensajes de los 3 días siguientes no se cobran.

Cómo ves lo que llevas

En Canales, debajo de tus números de WhatsApp API, la tarjeta Uso de Meta muestra cuántas respuestas gratis llevas en el mes, lo que Meta te cobró y cuántos mensajes salieron gratis por anuncios. La ven el dueño y los administradores. Además, Yolani te avisa (por correo y en el panel) cuando un número llega a 800 respuestas del mes y cuando Meta empieza a cobrarlas.

Para que el cupo rinda, en WhatsApp API tu agente junta cada respuesta en un solo mensaje (y el texto va como pie de la foto cuando la manda) en lugar de varias burbujas, porque cada burbuja cuenta como un mensaje. Se apaga en la configuración del agente, con Un solo mensaje en WhatsApp oficial.

Cuando algo falla

Comparación rápida