Listar respuestas rápidas

Obtiene una lista de la configuración de respuestas rápidas disponibles para el dispositivo específico.

API de WhatsApp y CRM

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

GET https://api.getincloud.ai/v1/devices/{deviceId}/quickReplies

Obtiene una lista de la configuración de respuestas rápidas disponibles para el dispositivo específico.

Las respuestas rápidas funcionan tanto con números de WhatsApp Personal como de WhatsApp Business.

Las respuestas rápidas se sincronizan automáticamente con tu número de WhatsApp Business, aunque puedes crear y usar respuestas rápidas sin crearlas en la aplicación de WhatsApp.

Ten en cuenta que los números de WhatsApp Personal no admiten respuestas rápidas de forma nativa, pero puedes crear y usar respuestas rápidas directamente desde el chat de la plataforma.

También puedes crear respuestas rápidas a nivel de plataforma que solo serán accesibles dentro de la aplicación de chat.

Los números de WhatsApp Personal también pueden crear y usar la función de respuestas rápidas desde la aplicación de chat.

Permisos:

Las respuestas rápidas creadas a nivel de plataforma mediante la API o desde la aplicación web pueden tener uno de los siguientes permisos de equipo:

public: todos los miembros del equipo pueden usar, editar y eliminar la respuesta rápida.

readonly: todos los miembros del equipo pueden usar la respuesta rápida, pero solo el propietario puede editarla o eliminarla.

private: solo el propietario puede usar, editar y eliminar la respuesta rápida.

Nota: este endpoint solo está disponible para dispositivos con un plan de producto Platform. De lo contrario, devolverá un estado de respuesta 403 - Forbidden.

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.

Parámetros

Campo	Dónde	Tipo	Obligatorio	Descripción
`scope`	query	string	No	Filtra las respuestas rápidas por ámbito de definición (`wa` = respuestas rápidas de solo lectura sincronizadas desde WhatsApp Business o `chat` = respuestas rápidas de lectura y escritura creadas en el chat). `enum: ['any', 'wa', 'chat']` · `default: any`
`permissions`	query	array	No	Filtra las respuestas rápidas por nivel de permiso (public, readonly o private). Se permiten varios valores en este filtro. `default: any`
`agents`	query	array	No	Filtra las respuestas rápidas creadas por el ID de agente de chat indicado (identificador hexadecimal de 24 caracteres). Si el agente no existe o no tiene acceso al chat, se devolverá un error `400 Bad Request`. Se permiten varios IDs de agente separados por comas.
`size`	query	number	No	Tamaño máximo de entradas a devolver `minimum: 1` · `maximum: 500` · `default: 100` · `format: integer`
`page`	query	number	No	Número de página de resultados (empezando desde 0) `minimum: 0` · `maximum: 100` · `default: 0` · `format: integer`

Respuestas

Código	Descripción
`200`	Lista de respuestas rápidas disponibles
`400`	Datos de consulta o de cuerpo de la solicitud no válidos
`401`	Acceso no autorizado debido a un token de API no válido o caducado
`403`	Función no disponible en el plan actual
`404`	Número no encontrado
`409`	Conflicto
`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

// Retrieve available quick replies
curl --request GET \
  --url https://api.getincloud.ai/v1/devices/{deviceId}/quickReplies \
  --header 'Token: <api token goes here>'

AnteriorListar facturas SiguienteObtener canal por ID

¿Te sirvió esta página?