Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Cómo añadir WhatsApp a tu SaaS con Embedded Signup y Coexistencia

Un SaaS añade WhatsApp conectando el número existente de cada cliente mediante Embedded Signup de Meta con Coexistencia, de modo que el número sigue funcionando en la app de WhatsApp Business. Con la Partner API de easyCoexistence, una sesión de conexión por cliente ejecuta ese flujo en una página alojada, Meta entrega los mensajes del número a tu webhook_url y tu backend responde a través de la Cloud API con el token propio del cliente.

20 mps

Throughput fijo de un número usado con la app de WhatsApp Business y con la Cloud API.

2.24.17

La versión más antigua de la app de WhatsApp Business con la que puede conectarse el número de un cliente mediante Coexistencia.

180 days

Cuánto historial de chats puede compartir Meta al incorporar; debe sincronizarse en 24 horas.

24 hours

La ventana de atención del servicio de WhatsApp tras un mensaje o llamada del usuario; cada nuevo mensaje la reinicia.

October 15, 2026

La fecha en que Meta dejó obsoletos Embedded Signup v2 y v3, con las integraciones migradas a v4.

¿Cuáles son las partes de una integración de WhatsApp?

Cinco, y easyCoexistence se encarga de la primera y la última. Tu producto conserva la lógica de conversación, la bandeja de entrada y lo que escriben tu modelo o el personal de tus clientes, mientras Meta transporta los mensajes entre el número y tu servidor:

1ConnectEmbedded Signup with Coexistence on a hosted page
2Routewebhook_url set on the number as it connects
3ReceiveMeta posts messages and echoes to your server
4ReplyCloud API calls with the customer's token
5WatchStatus events when the number drops or returns

¿Qué cambia Coexistencia para tus clientes?

Conservan su número y su teléfono. La app de WhatsApp Business sigue funcionando junto a la Cloud API, así que el personal responde desde el teléfono mientras tu producto responde a través de la API, y lo que envían desde la app llega a tu webhook como smb_message_echoes. Vienen con tres límites: el número envía con un throughput fijo de 20 mensajes por segundo, solo la API puede enviar plantillas, y Meta desconecta el número si el teléfono permanece inactivo unos 14 días.

¿Cómo es el paso de conexión en tu producto?

Un botón «Connect WhatsApp» que llama a POST /connect-sessions desde tu backend con un redirect_url, el id de tu cliente como external_ref y webhook_url con webhook_verify_token, de modo que Meta dirija el número hacia ti desde el primer minuto. El cliente confirma una lista breve en la página alojada, ejecuta la ventana emergente de Meta, escanea un código QR con la app de WhatsApp Business y regresa a ti con un connection_id. Si conviene ejecutar Embedded Signup desde tu propia app de Tech Provider, lo explica la guía de Embedded Signup.

¿Cómo llegan los mensajes a tu backend?

Desde Meta, directamente a webhook_url, sin pasar por easyCoexistence y sin copia guardada. El campo messages transporta lo que envían los clientes y el estado de lo que tú envías, y smb_message_echoes transporta lo que el personal envía desde la app. Meta firma cada entrega con el secreto de la app de easyCoexistence, que nunca se comparte, así que un secreto largo y aleatorio en la ruta de la URL la autentica. Dos números dentro de una misma cuenta de WhatsApp Business comparten destino: enruta por value.metadata.phone_number_id.

¿Cómo responde tu backend y envía plantillas?

Con la Graph API de Meta y el token del cliente obtenido de GET /connections/{id}?credentials=1, que además devuelve send_endpoint. El texto libre sale dentro de las 24 horas posteriores al último mensaje de la persona; después, solo una plantilla que Meta haya aprobado:

  • Respuesta: POST /<PHONE_NUMBER_ID>/messages con type text, dentro de la ventana.
  • Plantilla: la misma llamada con type template, el nombre de la plantilla y su código de idioma.
  • Crear una plantilla: POST /<WABA_ID>/message_templates, y luego consulta su estado, ya que los resultados de la revisión no llegan a webhook_url.
  • Multimedia: POST /<PHONE_NUMBER_ID>/media para subir; el contenido recibido llega como un ID que se recupera con el mismo token.
Reply inside the customer service window
curl -X POST "$SEND_ENDPOINT" \
  -H "Authorization: Bearer $CUSTOMER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "5511987654321",
    "type": "text",
    "text": { "body": "Your table for 4 is booked for 8 pm." }
  }'

¿Puede tu producto importar los chats existentes del cliente?

Una sola vez, al conectar. Con webhook_url definido en la sesión, easyCoexistence pide a Meta que envíe los contactos del número y, si el cliente lo acepta en la app, hasta 180 días de chats, que llegan como webhooks smb_app_state_sync e history. Meta lo permite solo dentro de las 24 horas posteriores a la conexión, así que el endpoint debe responder antes de enviar el enlace. La guía del historial de chats describe las cargas útiles.

¿Quién paga a Meta por los mensajes?

Tu cliente. Meta factura los mensajes que tu backend envía a través de la API a la cuenta de WhatsApp Business del cliente, con un método de pago que él añade allí, y una empresa sin ninguno no puede enviar plantillas de marketing. easyCoexistence cobra a tu cuenta por número conectado y nunca cobra por mensajes ni aplica margen sobre los precios de Meta.

¿Qué ocurre cuando un número se desconecta?

Tu URL de eventos recibe connection.disconnected con el motivo de Meta cuando se conoce. PRIMARY_INACTIVITY es la regla de los 14 días, y una nueva sesión de conexión para ese cliente devuelve el mismo número. connection.token_missing indica que el número se conectó sin el token del cliente, así que recibe mensajes pero no puede enviarlos hasta que una nueva sesión lo reconecte.

Errores comunes

  • Enviar el enlace de conexión antes de que tu endpoint de webhook responda. La importación del historial se ejecuta una sola vez, dentro de las 24 horas posteriores a la conexión, y el contenido enviado antes de que tu URL funcione se pierde.
  • Responder con texto libre después de cerrarse la ventana. Pasadas 24 horas desde el último mensaje de la persona, solo se entrega una plantilla aprobada.
  • Lanzar una campaña desde un número a máxima velocidad. Un número con Coexistencia envía a 20 mensajes por segundo, así que pon en cola los envíos de cada número a esa tasa.
  • Esperar que el personal envíe plantillas desde el teléfono. En Coexistencia solo la API las envía, así que pon los envíos de plantillas en tu producto.
Hacerlo con EasyCoexistence

easyCoexistence añade WhatsApp a tu SaaS con Embedded Signup de Meta y Coexistencia en una página alojada que muestra tu nombre: tus clientes conservan su número y la app de WhatsApp Business, Meta entrega los mensajes a tu servidor y te llegan como eventos firmados. La misma API conecta Instagram, Facebook, TikTok, YouTube, LinkedIn y más canales que se suman con el tiempo. De US$ 9 a US$ 0.75 por conexión al mes, y el precio baja a medida que añades conexiones, con los primeros 3 días gratis.

Preguntas frecuentes

¿Puede un cliente conectar un número que está en otro proveedor de API de WhatsApp?

Mientras esté allí, no. La lista de la página alojada pide un número sin otro proveedor de API ni herramienta de automatización, así que el cliente primero lo desconecta de ese proveedor.

¿Puede mi SaaS enviar plantillas de WhatsApp a sus clientes?

Sí, a través de la Cloud API con el token de cada cliente: crea la plantilla en su cuenta de WhatsApp Business, espera la revisión de Meta y luego envíala.

¿easyCoexistence lee los mensajes de WhatsApp de mis clientes?

No. Meta entrega los mensajes de un número directamente a la webhook_url que defines. Un número sin webhook_url recurre al callback de easyCoexistence, donde los mensajes se descartan sin guardarse.

¿Cuánto cuesta easyCoexistence por número de WhatsApp?

De US$ 9 a US$ 0.75 por número al mes, según el tramo de tus conexiones totales, con los primeros 3 días gratis. Los cargos de mensajes de Meta van a la cuenta de WhatsApp Business de cada cliente.

Sigue leyendo

Conecta tu primer canal en dos minutos.

Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.

  • 3 días gratis
  • Cancela cuando quieras
  • Solo APIs oficiales
  • Monitorizado 24/7

Verificado el