Perfiles de clientes y tickets
Consulta y sincroniza perfiles de clientes, y crea tickets desde tu sistema.
4.4 Perfil del cliente
Las conversaciones de un mismo cliente se agrupan en un único perfil de cliente, al que apunta el contact_id de la conversación. Regla de identificación: el ID de miembro que firmas (user_token o el user.id enviado por la API) > el usuario del canal (por ejemplo, el openid de WeChat) > el visitante web. Cuando un visitante anónimo inicia sesión, se fusiona con el perfil del miembro; dos miembros distintos no se fusionan automáticamente: si coinciden en correo electrónico o teléfono, solo se muestra un aviso en el panel de administración y el equipo de atención al cliente los fusiona manualmente.
| Método | Ruta | Descripción |
|---|---|---|
| GET | /v1/contacts?user_id= o ?email= | Busca un perfil de cliente por tu ID de miembro o por correo electrónico |
| GET | /v1/contacts/{id} | Perfil del cliente: nombre, correo electrónico, teléfono, etiquetas tags, notas notes, campos personalizados attributes, número de conversaciones, hora de la última visita e ID de miembro user_ids |
| PATCH | /v1/contacts/{id} | Sincroniza los datos desde tu sistema: name, phone, tags (máximo 30), notes, attributes (se reemplazan por completo, máximo 30 campos). Envía solo los campos que quieras modificar |
4.5 Tickets
| Método | Ruta | Descripción |
|---|---|---|
| POST | /v1/tickets | Crea un ticket, por ejemplo desde el formulario «Contáctanos» de tu sitio web: subject, description, priority (urgent / high / normal / low), name / email / phone del cliente y, opcionalmente, conversation_id o contact_id asociados. Si hay correo electrónico, las respuestas del equipo de atención al cliente se envían al cliente por email |
| GET | /v1/tickets/{id} | El ticket y su línea de tiempo (mensajes del cliente, respuestas del equipo, cambios de estado; no incluye notas internas) |
Estados del ticket: open pendiente de atención, pending en espera del cliente, resolved resuelto, closed cerrado. El plazo de respuesta se configura por prioridad en «Configuración del bot».
¿Te ha resultado útil esta página?
Última actualización:
