Enviar estado de escritura

Envía el estado de escritura o de grabación de WhatsApp en un chat de usuario o en un chat de grupo.

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/chat/{deviceId}/typing

Envía el estado de escritura o de grabación de WhatsApp en un chat de usuario o en un chat de grupo.

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í	Estado de escritura que se establecerá en el chat de destino. Usa `stop` para pausar el estado de escritura anterior. `enum: ['typing', 'recording', 'stop']` · `default: typing`
`duration`	integer	No	Duración en segundos durante la cual el estado de escritura o grabación permanecerá activo en el chat específico. Por defecto es de 2 segundos y el máximo es de 30 segundos. `minimum: 2` · `maximum: 30`
`chat`	string	No	Número de teléfono del chat de usuario en formato E.164, por ejemplo: `+1234567890` `minLength: 8` · `maxLength: 16`
`group`	string	No	ID del chat de grupo en el formato indicado. Ejemplo: `123456789000000000@g.us` `minLength: 10` · `maxLength: 50`

Respuestas

Código	Descripción
`200`	Estado de escritura actualizado
`400`	Datos de consulta o de 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

// Send typing status in a user chat
curl --request POST \
  --url https://api.getincloud.ai/v1/chat/{deviceId}/typing \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"action":"typing","chat":"+1234567890","duration":5}'


// Send typing status in a group chat
curl --request POST \
  --url https://api.getincloud.ai/v1/chat/{deviceId}/typing \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"action":"typing","group":"123456789000000000@g.us","duration":5}'


// Send recording status in a user chat
curl --request POST \
  --url https://api.getincloud.ai/v1/chat/{deviceId}/typing \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"action":"recording","chat":"+1234567890","duration":15}'


// Send recording status in a group chat
curl --request POST \
  --url https://api.getincloud.ai/v1/chat/{deviceId}/typing \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"action":"recording","group":"123456789000000000@g.us","duration":10}'


// Send stop typing/recording status in a user chat
curl --request POST \
  --url https://api.getincloud.ai/v1/chat/{deviceId}/typing \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"action":"stop","chat":"+1234567890"}'


// Send stop typing/recording status in a group chat
curl --request POST \
  --url https://api.getincloud.ai/v1/chat/{deviceId}/typing \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"action":"stop","group":"123456789000000000@g.us"}'

AnteriorEliminar nota SiguienteEstablecer metadatos

¿Te sirvió esta página?