Listar plantillas de WhatsApp

Obtén una lista paginada de las plantillas de WhatsApp disponibles en tu organización.

GET /api/v1/templates

List WhatsApp templates

cURL

curl --request GET \
  --url https://app.flowella.io/api/v1/templates \
  --header 'Authorization: Bearer <token>'

200

{
  "items": [
    {
      "id": "<string>",
      "name": "<string>",
      "language": "<string>",
      "status": "<string>",
      "wabaId": "<string>",
      "whatsappChannelId": "<string>",
      "metaTemplateId": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "nextCursor": "<string>"
}

Devuelve una lista paginada de las plantillas de WhatsApp, incluyendo tanto las aprobadas en Meta como los borradores locales. Puedes filtrar por estado para encontrar plantillas listas para usar.

​

Autenticación

Todas las solicitudes requieren la cabecera Authorization: Bearer <api_key> con una clave que empieza por el prefijo flo_.

​

Parámetros de consulta

limit · integer · predeterminado: "25"

Número máximo de elementos por página (entre 1 y 100).

cursor · string

Cursor de paginación devuelto en nextCursor de la respuesta anterior.

status · string

Filtra por TemplateStatus (por ejemplo APPROVED, PENDING, REJECTED).

​

Respuesta

items · array · requerido

Array de plantillas con los campos id, source (meta o draft), name, language, status, wabaId, whatsappChannelId, metaTemplateId, createdAt y updatedAt.

nextCursor · string

Cursor para la siguiente página. Si falta, se ha llegado al final.

​

Errores

Código	Significado
400	Parámetros de consulta no válidos.
401	Falta la clave de API o no es válida.
429	Limitado por tasa.

​

Ejemplo

curl "https://app.flowella.io/api/v1/templates?status=APPROVED&limit=50" \
  -H "Authorization: Bearer flo_xxxxxxxxxxxxxxxxxxxxxxxx"

Autorizaciones

Authorization · string · header · requerido

Organization API key (flo_…). Send as Authorization: Bearer <key>.

Parámetros de consulta

limit · integer · predeterminado: 25

Rango requerido: 1 <= x <= 100

cursor · string

status · string

Filter by TemplateStatus (e.g. APPROVED, PENDING, REJECTED).

whatsappChannelId · string

search · string

Maximum string length: 200

Respuesta

200

application/json

Paginated templates

items · object[] · requerido

Show child attributes

nextCursor · string