Actualizar la asignación automática de chats

Activa o desactiva y actualiza la configuración de asignación automática de chats para el número de WhatsApp actual.

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/devices/{deviceId}/autoassign

Activa o desactiva y actualiza la configuración de asignación automática de chats para el número de WhatsApp actual.

La asignación automática de chats te permite definir los criterios internos con los que los chats se asignarán automáticamente a los miembros de tu equipo.

Opciones de configuración admitidas:

offline boolean: Activa o desactiva la asignación de chats a usuarios sin conexión o no disponibles.

reassign boolean: Activa o desactiva la reasignación de chats si el usuario asignado previamente no está en línea o disponible.

excludeRoles array[string]: Lista opcional de roles de usuario que se excluirán siempre de la asignación automática de chats.

excludeUsers array[string]: Lista opcional de IDs de usuario que se excluirán siempre de la asignación automática de chats.

labels array[string]: Lista opcional de etiquetas que el sistema agregará a los chats asignados automáticamente.

Importante: la función de asignación automática solo está disponible para números que usan los planes Platform Business y Enterprise.

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 juega con 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
`active`	boolean	Sí	Activa o desactiva la política de asignación automática de chats.
`online`	boolean	No	Asigna chats automáticamente solo a usuarios en línea. No se puede usar con las opciones `away`, `unavailable` u `offline`.
`away`	boolean	No	Activa o desactiva la asignación de chats a usuarios `away` que han estado inactivos durante más de 5 minutos.
`unavailable`	boolean	No	Activa o desactiva la asignación de chats a usuarios con estado `unavailable`, estén en línea o no.
`offline`	boolean	No	Activa o desactiva la asignación de chats a usuarios sin conexión que han estado inactivos durante más de 5 minutos.
`reassign`	boolean	No	Activa o desactiva la reasignación de chats si el usuario asignado previamente no está en línea o disponible.
`reassignOptions`	object	No	Si `reassign` es `true`, define opcionalmente opciones personalizadas de reasignación de chats.
`reassignOptions.resolved`	boolean	No	Reasigna chats resueltos si el usuario asignado actualmente no está en línea o disponible. Por defecto: `false`
`reassignOptions.active`	boolean	No	Reasigna chats activos aún no resueltos si el usuario asignado actualmente no está en línea o disponible. Por defecto: `false`
`reassignOptions.unassign`	boolean	No	Desasigna los chats si no hay usuarios disponibles que puedan recibir la reasignación. Por defecto: `false`
`reassignOptions.labels`	array<string>	No	Omite la reasignación de chats si alguna de las siguientes etiquetas está presente en el chat.
`excludeRoles`	array<string>	No	Lista opcional de roles de usuario que se excluirán siempre de la asignación automática de chats.
`excludeUsers`	array<string>	No	Lista opcional de IDs de usuario que se excluirán siempre de la asignación automática de chats.
`excludeDepartments`	array<string>	No	Lista opcional de IDs de departamento que se excluirán siempre de la asignación automática de chats, incluidos los miembros de su equipo.
`excludeNumbers`	array<string>	No	Lista opcional de números de teléfono que se excluirán de la asignación automática de chats. El número de teléfono debe estar en formato E.164, por ejemplo: +16001234560
`labels`	array<string>	No	Lista opcional de etiquetas que el sistema agregará a los chats asignados automáticamente.

Respuestas

Código	Descripción
`200`	Configuración de asignación automática actualizada correctamente
`400`	Campos del cuerpo inválidos o ausentes
`401`	Acceso no autorizado por token de API inválido o expirado
`403`	Usuario no autorizado o falta el token de API requerido
`404`	Número no encontrado
`409`	Conflicto: función inválida o no compatible con tu plan
`429`	Demasiadas solicitudes: inténtalo de nuevo más tarde
`500`	Error inesperado
`501`	No implementado
`503`	Servicio temporalmente no disponible: 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

// Update chats automatic assignment configuration for the current WhatsApp number
curl --request PATCH \
  --url https://api.getincloud.ai/v1/devices/{deviceId}/autoassign \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"active":true,"offline":true,"reassign":true,"labels":["label1","label2"],"excludeRoles":["admin"],"excludeUsers":[]}'

AnteriorActualizar imagen del canal SiguienteActualizar número

¿Te sirvió esta página?