Asignar chat

Asigna o reasigna un chat a un miembro del equipo por ID de usuario o correo electrónico, a un departamento, o ambos.

API de WhatsApp y CRM

Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.

PATCH https://api.getincloud.ai/v1/chat/{deviceId}/chats/{chatWid}/owner

Asigna o reasigna un chat a un miembro del equipo por ID de usuario o correo electrónico, a un departamento, o ambos.

Cuando se asigna un chat, pasará automáticamente del estado pending al estado active.

Nota: los departamentos del equipo son una función limitada, disponible solo en los planes Business y Enterprise; de lo contrario, la API devolverá un error.

Prueba este endpoint en el probador de API en vivo

>¿Necesitas ayuda? Explora todos los tutoriales, más de 100 ejemplos de casos de uso y prueba el probador de API en vivo con ejemplos de código listos para usar en más de 15 lenguajes de programación, incluidos JavaScript/Node.js, PHP, Python, C#, Java, Ruby, Swift, Kotlin, Powershell, cURL y más.

Autenticación

Envía tu API key en el encabezado Token en cada petición.

Cuerpo de la petición

Campo	Tipo	Obligatorio	Descripción
`agent`	string	No	ID de usuario del agente al que se asignará el chat. Es obligatorio si los campos `email` y `department` no están presentes. `minLength: 24` · `maxLength: 24` · `pattern: ^[0-9A-Fa-f]{24}$`
`email`	string	No	Correo electrónico del agente al que se asignará el chat. Es obligatorio si los campos `agent` y `department` no están presentes. `minLength: 5` · `maxLength: 100` · `format: email`
`department`	string	No	ID del departamento al que se asignará el chat. Es obligatorio si los campos `agent` y `email` no están presentes. `minLength: 24` · `maxLength: 24` · `pattern: ^[0-9A-Fa-f]{24}$`

Respuestas

Código	Descripción
`200`	Chat asignado correctamente
`400`	Datos de consulta o del cuerpo de la solicitud no válidos
`401`	No autorizado: token de API no válido o ausente
`403`	Faltan los permisos necesarios
`404`	Recurso no encontrado
`409`	Conflicto
`429`	Demasiadas solicitudes: inténtalo de nuevo más tarde
`500`	Error inesperado
`501`	No implementado
`503`	Servicio no disponible temporalmente: inténtalo de nuevo más tarde

// This code example requires you to have installed curl package
// Installation instructions here: https://curl.haxx.se/download.html

// Assign chat to an agent by ID
curl --request PATCH \
  --url https://api.getincloud.ai/v1/chat/{deviceId}/chats/{chatWid}/owner \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"agent":"5f70af51009f418374e390d2"}'


// Assign chat to an agent by email
curl --request PATCH \
  --url https://api.getincloud.ai/v1/chat/{deviceId}/chats/{chatWid}/owner \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"email":"agent@company.com"}'


// Assign chat to a department by ID
curl --request PATCH \
  --url https://api.getincloud.ai/v1/chat/{deviceId}/chats/{chatWid}/owner \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"department":"{DEPARTMENT_ID}"}'


// Assign chat to a department and agent by ID
curl --request PATCH \
  --url https://api.getincloud.ai/v1/chat/{deviceId}/chats/{chatWid}/owner \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"department":"{DEPARTMENT_ID}","agent":"{AGENT_ID}"}'

AnteriorArchivos SiguienteBuscar chats

¿Te sirvió esta página?