Saltar al contenido principal
Los endpoints de WhatsApp te permiten leer las cuentas remitentes conectadas de la organización y enviar un mensaje puntual a un lead — de inmediato, fuera del motor de secuencias. Los mensajes enviados se hilan en la conversación del inbox del lead. Cada endpoint en esta página opera dentro del tenant de la organización que llama — no puedes leer ni escribir cuentas ni mensajes de WhatsApp de otra organización con la misma key.
Una credencial personal lista y envía solo desde la cuenta conectada propia del member. Cuenta global u otra de member → 403 FORBIDDEN. La auditoría no guarda el cuerpo del mensaje.

Listar cuentas de WhatsApp

Scope: whatsapp:read. Lista las cuentas remitentes de WhatsApp conectadas de la organización. Usa el id devuelto como whatsappAccountId al crear una secuencia de WhatsApp o al enviar un mensaje.

Request

Response 200


Enviar un mensaje de WhatsApp

Scope: whatsapp:write. Envía un mensaje puntual de WhatsApp a un único lead de inmediato — fuera del motor de secuencias. El mensaje se envía desde la cuenta indicada y se hila en la conversación del inbox del lead.
Esto cuesta 1 unidad mensual de tu cuota, como cualquier request ordinario. Ver Rate limits.

Request body

Request

Response 200

Errores comunes

  • 404 NOT_FOUND — el lead no existe o pertenece a otra organización.
  • 400 OPTED_OUT — el lead se dio de baja de WhatsApp y no se le puede mensajear.
  • 400 ACCOUNT_UNAVAILABLE — la cuenta de WhatsApp no se encontró o no está conectada.
  • 400 BAD_REQUEST — el lead no tiene un número de teléfono válido.
  • 400 VALIDATION_ERROR — body inválido (p. ej. message vacío, leadId no es un UUID, media.type inválido).
  • 403 FORBIDDEN — credencial personal usando una cuenta que no es del caller.
  • 429 NUMBER_RATE_LIMITED — el número está pausado o sin presupuesto.