Listar conversaciones

Obtén una lista paginada de conversaciones de la bandeja de entrada, con filtrado opcional por estado.

GET /api/v1/conversations

List conversations

cURL

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

200

{
  "items": [
    {
      "id": "<string>",
      "status": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "whatsappChannelId": "<string>",
      "contact": {
        "id": "<string>",
        "phone": "<string>",
        "name": "<string>",
        "waId": "<string>"
      },
      "lastMessageAt": "2023-11-07T05:31:56Z"
    }
  ],
  "nextCursor": "<string>"
}

Devuelve un listado paginado de las conversaciones de la organización. Usa el cursor de la respuesta para obtener las páginas siguientes.

​

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 ConversationStatus (por ejemplo, conversaciones abiertas o cerradas).

​

Respuesta

items · array · requerido

Array de conversaciones con los campos id, status, lastMessageAt, createdAt, whatsappChannelId y un objeto contact con id, name, phone y waId.

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.
402	Pago requerido: tu suscripción no cubre esta acción.
429	Limitado por tasa.

​

Ejemplo

curl "https://app.flowella.io/api/v1/conversations?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 ConversationStatus.

Respuesta

200

application/json

Paginated conversations

items · object[] · requerido

Show child attributes

nextCursor · string