Clientes
Los clientes representan a las personas que interactúan con tus agentes. Puedes almacenar información de contacto, campos personalizados y etiquetas para segmentarlos.
Endpoints disponibles
| Método | Endpoint | Descripción |
|---|---|---|
GET | /v1/clients | Listar todos los clientes |
GET | /v1/clients/{id} | Obtener un cliente por ID o teléfono |
POST | /v1/clients | Crear un nuevo cliente |
PATCH | /v1/clients/{id} | Actualizar un cliente por teléfono |
DELETE | /v1/clients/{id} | Eliminar un cliente por ID o teléfono |
GET | /v1/clients/{clientId}/conversations | Listar todas las conversaciones de un cliente |
PATCH | /v1/clients/{id}/moderation | Bloquear, desbloquear o restablecer strikes |
Los clientes pueden tener campos personalizados definidos por workspace. Consulta la sección de Campos Personalizados para listarlos, crearlos, actualizarlos o eliminarlos.
Estado y moderación
Cada cliente tiene un status (active o blocked) y un objeto moderation con su historial. Un cliente bloqueado deja de recibir respuestas automáticas: sus conversaciones nuevas nacen marcadas como spam y los agentes las omiten.
Los strikes los acumula el sistema de moderación cuando detecta contenido que viola las reglas de seguridad del agente, y al cruzar el límite del agente el cliente se bloquea solo. Para intervenir a mano hay un solo endpoint, Moderar un Cliente , donde declaras cómo quieres que quede.
Desbloquear a un cliente le restablece los strikes, porque si no la siguiente falta volvería a cruzar el límite de inmediato. Al revés no aplica: restablecer los strikes de un cliente bloqueado no lo desbloquea.
/moderation acepta el ID del cliente o su teléfono. PATCH /v1/clients/{id}, en cambio, sólo acepta el teléfono, así que para contactos sin número (webchat, Instagram, Telegram) usa /moderation.