Requisitos:
Tu X-Tenant.
https://help.convos.la/es/articles/8452332-x-tenant
Un token con la habilidad de "Tickets".
Configuración de la request
Descripción | Consultar tickets desde aplicación externa. |
HTTP Method | GET |
Headers | X-Tenant: {YourXTenant} |
URL | https://api.convos.la/consumer/tickets |
Paginación y filtrado (ejemplo) | Ver ejemplos debajo |
Filtros disponibles (query params)
Todos los filtros son opcionales.
Parámetro | Tipo | Default | Descripción |
|
| — | Filtra por ID de ticket específico |
|
| — | Filtra por ID de contacto |
|
| — | Filtra por ID de bandeja de entrada |
|
| — | Filtra por ID de operador asignado |
|
| — | Filtra por ID de diálogo/flujo |
|
| — | Estado del ticket (ej: |
|
| — | Fecha inicio en la zona horaria del tenant. Formato: |
|
| — | Fecha fin en la zona horaria del tenant. Formato: |
|
|
| Campo de ordenamiento |
|
|
| Dirección de ordenamiento ( |
|
|
| Cantidad de resultados por página |
|
| — | Para paginación por cursor: retorna tickets con ID mayor al indicado |
Paginado
La respuesta usa paginación estándar.
Se navega entre páginas con el query param page (ej: ?page=2&per_page=50).
Opcionalmente se puede usar last_ticket_id como paginación.
La respuesta incluye los metadatos: current_page, first_page_url, from, last_page, last_page_url, links, next_page_url, path, per_page, prev_page_url, to, total.
Ejemplo de respuesta
{
"current_page": 1,
"data": [
{
"id": 150,
"name": "Ticket #150",
"description": "Descripción del ticket",
"status": "open",
"created_at": "2026-03-19 10:30:00",
"updated_at": "2026-03-19 11:00:00",
"expires_at": "2026-03-22 10:30:00",
"closed_at": null,
"project_id": 5,
"inbox_id": 3,
"user_id": 10,
"contact_id": 42,
"dialog_id": 7,
"latest_message_id": 890,
"url": "https://example.com/conversations?ticket_id=150&contact_id=42",
"contact": {
"id": 42,
"source": "whatsapp",
"name": "Juan Pérez",
"email": "[email protected]",
"cellphone": "+5491155667788",
"firstname": "Juan",
"lastname": "Pérez"
},
"inbox": {
"id": 3,
"name": "Soporte General"
},
"user": {
"id": 10,
"name": "María López",
"email": "[email protected]"
},
"dialog": {
"id": 7,
"name": "Flujo de bienvenida"
},
"latest_message": {
"id": 890,
"type": "text",
"subtype": "inbound",
"created_at": "2026-03-19 10:55:00"
}
}
],
"first_page_url": "https://api.example.com/consumer/tickets?page=1",
"from": 1,
"last_page": 3,
"last_page_url": "https://api.example.com/consumer/tickets?page=3",
"next_page_url": "https://api.example.com/consumer/tickets?page=2",
"path": "https://api.example.com/consumer/tickets",
"per_page": 100,
"prev_page_url": null,
"to": 100,
"total": 250
}