API de WhatsApp y CRM
POST/devices/{deviceId}/removechats

Eliminación automática de chats

Configura la tarea de limpieza/eliminación automática de los chats más antiguos en tu número de WhatsApp.

API de WhatsApp y CRM
Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.
POST https://api.getincloud.ai/v1/devices/{deviceId}/removechats

Configura la tarea de limpieza/eliminación automática de los chats más antiguos en tu número de WhatsApp.

Esta función es especialmente útil cuando envías miles de mensajes a diferentes números o cuando tu número recibe muchos mensajes de usuarios de terceros.

Cuando está habilitada, el sistema se encargará de eliminar automáticamente los chats antiguos cada pocos minutos de la sesión de tu dispositivo.

¿Por qué existe esta función?

Tener muchos chats abiertos reduce el rendimiento o incluso puede dejar tu dispositivo inoperativo. Recomendamos habilitar esta función si planeas enviar mensajes a miles de usuarios diferentes.

Recomendamos a los clientes con un volumen de envío medio o alto que habiliten esta función.

¿Con qué frecuencia se eliminarían los chats?

Los chats se eliminarían cada 2 minutos.

Si la sesión del dispositivo no está en línea, los chats se eliminarán en cuanto la sesión vuelva a estar operativa.

¿Cuál es el límite máximo predeterminado de chats abiertos?

Si se habilita, por defecto permitirá hasta 500 chats activos. Puedes personalizar el límite máximo de 100 a 1000 chats.

¿Cómo afecta al rendimiento tener cientos de chats?

Según nuestras pruebas, tener más de 500 chats abiertos puede afectar el rendimiento de tu dispositivo y reducir la velocidad de envío de mensajes.

A menos que sea estrictamente necesario, considera un valor más bajo.

No quiero eliminar todos los chats. ¿Puedo omitir algunos?

Sí, puedes.

Si no quieres eliminar ciertos chats, puedes agregar hasta 100 números de teléfono a la lista blanca.

¿Qué tipo de chats se eliminarían?

Solo se ven afectados los chats de usuarios.

Los chats de grupo, las listas de difusión y los chats de usuarios fijados se ignoran y no se eliminarán.

¿Cómo funciona el criterio de limpieza?

Es muy sencillo: el sistema elimina automáticamente los chats más antiguos una vez que se supera el máximo de chats permitido.

Cabe destacar que los chats de grupo, de difusión y fijados se ignoran y no se eliminarán.

¿Qué planes de dispositivo admiten esta función?

Todos los planes disponibles admiten esta función.


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

CampoTipoObligatorioDescripción
enablebooleanNoHabilita o deshabilita la eliminación automática de chats. default: True
maxnumberNoNúmero máximo de chats activos más recientes que se conservarán; el resto se elimina, empezando por los más antiguos. enum: [100, 200, 300, 400, 500, 600, 700, 800, 900, 1000, 1250, 1500, 1750, 2000, 2500, 3000, 3500, 4000, 4500, 5000] · minimum: 100 · format: float
whitelistarray<object>NoLista blanca opcional de números de teléfono que NO serán eliminados por la eliminación automática de chats.

Respuestas

CódigoDescripción
200Modelo del dispositivo
400Datos de consulta o cuerpo de la solicitud no válidos
401Acceso no autorizado por token de API no válido o vencido
403Falta el token de API requerido
404Número no encontrado
409Conflicto
429Demasiadas solicitudes - Inténtalo de nuevo más tarde
500Error inesperado
501No implementado
503Servicio 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

// Enable automatic chats removal, allowing a maximum of 500 open chat at a time
curl --request POST \
  --url https://api.getincloud.ai/v1/devices/{deviceId}/removechats \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"enable":true,"max":500}'


// Disable automatic chats removal in the device
curl --request POST \
  --url https://api.getincloud.ai/v1/devices/{deviceId}/removechats \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"enable":false}'


// Enable chats clean up with some whitelist numbers
curl --request POST \
  --url https://api.getincloud.ai/v1/devices/{deviceId}/removechats \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"enable":true,"whitelist":[{"phone":"+1234567890","alias":"Boss"},{"phone":"+9876543210","alias":"Support team"}]}'
AnteriorDesconectar sesiónSiguienteEliminar canal
¿Te sirvió esta página?