Endpoint ·
GET /quick-repliesEndpoint de solo consulta: devuelve información y no modifica nada. No se manda dentro del array
actions — se llama directo.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 ennext_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.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.