Saltar al contenido principal
GET
/
api
/
v1
/
conversations
List conversations
curl --request GET \
  --url https://app.flowella.io/api/v1/conversations \
  --header 'Authorization: Bearer <token>'
{
  "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>"
}

Documentation Index

Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt

Use this file to discover all available pages before exploring further.

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ódigoSignificado
400Parámetros de consulta no válidos.
401Falta la clave de API o no es válida.
402Pago requerido: tu suscripción no cubre esta acción.
429Limitado 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

Paginated conversations

​
items
object[]
requerido
​
nextCursor
string