Lead Inbox para developers · precios y piloto

El WhatsApp de tus clientes, dentro de tu software

Conecta el WhatsApp de tus clientes a tu plataforma con la API oficial de Meta. Sus vendedores siguen usando la app de WhatsApp Business en el celular, y todo lo que mandan y reciben te llega por API, ligado al cliente correcto. Y lanza campañas desde tu producto con el mismo motor de Lead Inbox.

Conceptos

Cuenta de partner

Tu empresa. Tiene las llaves de API, los webhooks y el plan. Una llave solo ve los inboxes que tú creaste o que un negocio conectó a tu cuenta. Un mismo negocio puede estar conectado a varios sistemas (por ejemplo, su CRM y su ERP) y cada uno recibe sus avisos.

Inbox

El negocio de uno de tus clientes con su número de WhatsApp. Lo creas por API y tu cliente lo conecta con un enlace. (Messenger e Instagram: la API ya los soporta, pendientes de aprobación de Meta para clientes externos.)

Conversación y contacto

Cada persona que le escribe al negocio, por cualquier canal (channel dice cuál). Les puedes poner tu propio external_id para ligarlos con tus registros.

Mensaje

Todo lo que entra y sale. El campo source dice de dónde salió: tu software (api), la app del celular (app), el asistente (bot) o el panel.

Oportunidad

Cada pedido de un contacto, en el embudo del negocio. Tiene un estado común (pending, sent, won, lost) para sincronizarla con tu CRM, y un external_id donde guardas el id de tu cotización.

Campaña

Un envío masivo por WhatsApp con plantilla aprobada, a contactos, listas o segmentos. Mismo motor que el panel: ritmo, bajas, cobro y seguimiento de entregas y respuestas.

Cómo se integra

1. 1Crea un inbox para tu cliente

   Regresa un connect_url. Ponlo detrás de un botón "Conecta tu WhatsApp" dentro de tu producto.

   curl https://www.leadinbox.com.mx/api/v1/inboxes \
     -H "Authorization: Bearer li_live_..." \
     -H "Idempotency-Key: 3c1f2a7e-..." \
     -d '{ "name": "Inmobiliaria Las Lomas", "external_id": "cust_8812" }'

2. 2Tu cliente conecta su WhatsApp

   El enlace abre el registro oficial de Meta. Si ya usa la app de WhatsApp Business, la conserva con su historial (Coexistencia). Al terminar recibes inbox.connected.

3. 3Recibe todo por webhook

   Lo que escriben sus contactos y lo que sus vendedores contestan, desde tu software o desde el celular.

   {
     "type": "message.sent",
     "inbox_id": "inb_7Hq2",
     "data": {
       "source": "app",
       "contact": { "phone": "+5215512345678", "external_id": "lead_5521" },
       "text": "Sí, ¿te late verlo mañana a las 11?"
     }
   }

4. 4Sincroniza las oportunidades con tu CRM

   Cuando el asistente califica a un contacto recibes lead.qualified con el deal_id. Cada cambio de etapa en Lead Inbox te llega como deal.stage_changed, y cuando tu vendedor mueve algo en tu CRM se lo pasas con PATCH.

   curl -X PATCH https://www.leadinbox.com.mx/api/v1/inboxes/inb_7Hq2/deals/deal_8Kp1 \
     -H "Authorization: Bearer li_live_..." \
     -d '{ "status": "sent", "external_id": "COT-2026-131" }'

5. 5Manda mensajes desde tu software

   Texto, archivos o plantillas, indicando qué usuario tuyo lo manda.

   curl https://www.leadinbox.com.mx/api/v1/inboxes/inb_7Hq2/messages \
     -H "Authorization: Bearer li_live_..." \
     -d '{ "to": "+5215512345678", "type": "text",
           "text": "Te comparto la propuesta.", "sent_by": "user_42" }'

6. 6Lanza campañas

   Una plantilla aprobada a una lista o a un segmento. Prueba primero con dry_run para ver destinatarios y créditos; al terminar recibes campaign.completed, y las respuestas llegan como cualquier mensaje.

   curl https://www.leadinbox.com.mx/api/v1/inboxes/inb_7Hq2/campaigns \
     -H "Authorization: Bearer li_live_..." \
     -H "Idempotency-Key: 9b2e..." \
     -d '{ "name": "Promo octubre",
           "template": { "name": "promo_octubre", "language": "es_MX", "variables": ["{{nombre}}"] },
           "audience": { "list_ids": ["3f1c..."] } }'

Lo que conviene saber