Actualización masiva de chats

Actualiza chats en modo masivo, hasta 1000 chats por llamada a la API.

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

Actualiza chats en modo masivo, hasta 1000 chats por llamada a la API.

Puedes realizar una acción masiva sobre un grupo de chats por llamada a la API.

Acciones masivas compatibles

resolve
unresolve
pin
unpin
mute
unmute
assign
unassign
block
unblock
read
unread
labels
remove

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
`action`	string	Sí	Acción que se realizará sobre los chats indicados. Ejemplo: `resolve` `enum: ['resolve', 'unresolve', 'pin', 'unpin', 'mute', 'unmute', 'assign', 'unassign', 'block', 'unblock', 'read', 'unread', 'labels', 'remove']`
`chats`	array<string>	No	Lista de IDs de chat o números de teléfono que se actualizarán. Ejemplo: +1234567890, 1234567890@c.us
`params`	object	No
`params.add`	array<string>	No	Solo se aplica a la acción `labels`. Lista de etiquetas que se añadirán a los chats indicados
`params.remove`	array<string>	No	Solo se aplica a la acción `remove`. Lista de etiquetas que se quitarán de los chats indicados
`params.agent`	string	No	Solo es obligatorio en la acción `assign`: define el ID del agente (hexadecimal de 24 caracteres) al que se asignarán los chats indicados. Se puede usar en combinación con el campo `department`. `minLength: 24` · `maxLength: 24` · `pattern: ^[0-9A-Fa-f]{24}$`
`params.department`	string	No	Solo se aplica a la acción `assign`: define el ID del departamento del equipo (hexadecimal de 24 caracteres) al que se asignarán los chats indicados. Se puede usar en combinación con el campo `agent` `minLength: 24` · `maxLength: 24` · `pattern: ^[0-9A-Fa-f]{24}$`

Respuestas

Código	Descripción
`200`	Chats actualizados 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

// Resolve multiple chats
curl --request POST \
  --url https://api.getincloud.ai/v1/chat/{deviceId}/bulk/chats \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"action":"resolve","chats":["1234567890@c.us","1234567890@c.us"]}'


// Mark multiple chats as unread
curl --request POST \
  --url https://api.getincloud.ai/v1/chat/{deviceId}/bulk/chats \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"action":"unread","chats":["1234567890@c.us","1234567890@c.us"]}'


// Assign multiple chats
curl --request POST \
  --url https://api.getincloud.ai/v1/chat/{deviceId}/bulk/chats \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"action":"assign","params":{"agent":"<AGENT-ID>"},"chats":["1234567890@c.us","1234567890@c.us"]}'


// Assign multiple chats to a department
curl --request POST \
  --url https://api.getincloud.ai/v1/chat/{deviceId}/bulk/chats \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"action":"assign","params":{"department":"<DEPARTMENT_ID>"},"chats":["1234567890@c.us","1234567890@c.us"]}'


// Unassign multiple chats
curl --request POST \
  --url https://api.getincloud.ai/v1/chat/{deviceId}/bulk/chats \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"action":"unassign","chats":["1234567890@c.us","1234567890@c.us"]}'


// Update labels
curl --request POST \
  --url https://api.getincloud.ai/v1/chat/{deviceId}/bulk/chats \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"action":"labels","chats":["1234567890@c.us","1234567890@c.us"],"params":{"add":["label1","label2"],"remove":["label3"]}}'

AnteriorObtener campañas SiguienteActualizar atributos del chat

¿Te sirvió esta página?