Skip to main content
Endpoint · GET /quick-replies
Endpoint de solo consulta: devuelve información y no modifica nada. No se manda dentro del array actions — se llama directo.
Devuelve el catálogo de respuestas rápidas del negocio, en orden alfabético y paginado por cursor. Cada item trae únicamente el name, y ese es el valor que después se pasa en quick_reply.name al armar una acción de envío. El catálogo no expone el contenido de la respuesta rápida (el shape de sus actions no se incluye): sirve para descubrir qué nombres existen, no para inspeccionar qué manda cada una. Parámetros
  • slug — slug del negocio en la ruta, sin distinguir mayúsculas. Debe coincidir con el negocio del token. Obligatorio.
  • search — substring del nombre, sin distinguir mayúsculas (1 a 100 caracteres). El asterisco * funciona como comodín y coincide con cualquier secuencia de caracteres; los caracteres % y _ se buscan literalmente. Opcional.
  • cursor — cursor opaco devuelto por la página anterior en next_cursor. Omitirlo para pedir la primera página. No reutilizar cursores entre endpoints distintos: aunque el formato sea idéntico, cada endpoint lo interpreta sobre su propio conjunto de datos. Opcional.
  • limit — respuestas rápidas por página. Por defecto 20, máximo 100. Opcional.

Respuesta

has_more indica si quedan resultados después de esta página. Mientras sea true, repetir la llamada pasando el valor de next_cursor en ?cursor= y manteniendo los mismos filtros. Cuando has_more es false, next_cursor llega en null.

Ejemplo

Es una lectura pura: pide la primera página del catálogo para ver qué nombres hay disponibles. La llamada no envía ningún mensaje ni modifica ninguna conversación — solo devuelve nombres, que después alimentan una acción de envío.
La página siguiente, con el cursor que devolvió la respuesta anterior:

Errores

Ver el catálogo completo en Errores. El name que devuelve esta consulta es exactamente el que consumen las acciones de envío: Enviar mensaje en modo respuesta rápida (quick_reply: { "name": ... }) y Enviar respuesta rápida o plantilla, que manda la respuesta rápida con la ventana de 24h abierta y la plantilla si está cerrada. El nombre se compara sin distinguir mayúsculas, pero conviene copiarlo tal cual viene del catálogo.