Conceptos clave

Cuentas

Una cuenta es un usuario final identificado mediante un número de teléfono E.164 (+228…).

Estado	Significado
`pending`	Invitado / todavía no verificado por completo
`claimed`	El usuario ha completado la verificación mediante OTP y puede utilizar la aplicación
`blocked`	Dado de baja / bloqueado

Los socios vinculan cuentas consigo mismos (M2M o campos del proveedor). Los usuarios vinculados ven a ese socio en su hub.

Un socio es una organización (p. ej., SEED) con:

Los mensajes de socio → usuario pueden ser:

Tipo	Comportamiento en el hub
Texto, medio, enlace, HTML	Mensajes de hub independientes (lista, los más recientes primero)
Invitaciones a flows	Tarjetas de flow independientes
Respuestas de soporte	Dentro de una conversación iniciada por el usuario

La API para socios POST /messages crea mensajes del hub, no hilos de chat de soporte.

`content_type`	Descripción
`text`	Texto sin formato
`image`	URL de imagen o base64
`document`	PDF / archivos
`audio`	Archivo de audio
`video`	Archivo de vídeo
`link`	Tarjeta CTA (url + label + title)
`html`	Newsletter móvil (HTML)
`flow`	Invitación a un formulario interactivo de varias etapas
`system`	Mensaje del sistema de la plataforma

Las conversaciones son hilos de soporte:

Se crean cuando un usuario inicia una solicitud de asistencia
Los agentes responden mediante Partner Hub / API de agente
Las sesiones de bot pueden usar asuntos como Bot · … (ocultos en el menú «Conversaciones» del usuario)

Se configuran por socio como una cadena ordenada, por ejemplo:

Los OTP y los mensajes críticos pueden forzar un subconjunto de canales.

Catálogo completo de las superficies del cliente, las herramientas para socios y el comportamiento de los canales: Plataformas.

Pase idempotency_key al enviar para evitar duplicados durante los reintentos:

{ "idempotency_key": "partner-order-98765" }

El mismo socio + la misma clave devuelve el mensaje original.