API de Etiquetas
Permite consultar el listado de etiquetas creadas en tu espacio de trabajo para clasificar contactos y conversaciones desde tus sistemas externos.
️ Listar Todas las Etiquetas
- Método:
GET - Ruta:
/api/v1/integrations/:integrationKey/labels - Autenticación:
Bearer sf_int_...
Ejemplo en cURL
curl -X GET "https://api.omniflou.com/api/v1/integrations/agendaconmigo/labels" \
-H "Authorization: Bearer sf_int_agendaconmigo_your_token"
Respuesta Exitosa (200 OK)
{
"docs": [
{
"_id": "603d2b2fe71c2100155b41d0",
"tenantId": "6a4ffc99e5956fd8d285c5aa",
"name": "Soporte Técnico",
"color": "#ff3b30",
"createdAt": "2026-08-01T10:00:00.000Z",
"updatedAt": "2026-08-01T10:00:00.000Z"
},
{
"_id": "603d2b2fe71c2100155b41d1",
"tenantId": "6a4ffc99e5956fd8d285c5aa",
"name": "Cita Confirmada",
"color": "#10b981",
"createdAt": "2026-08-01T10:05:00.000Z",
"updatedAt": "2026-08-01T10:05:00.000Z"
}
]
}
️ Códigos de Error HTTP Comunes
| Código | Significado | Causa Frecuente |
|---|---|---|
400 Bad Request |
Parámetros inválidos | Número de teléfono sin prefijo + o fecha de programación pasada. |
401 Unauthorized |
No autorizado | Falta la cabecera Authorization o el token es inválido/revocado. |
403 Forbidden |
Prohibido | El token no tiene permisos para la clave de integración especificada. |
404 Not Found |
No encontrado | El recurso solicitado (mensaje o contacto) no existe. |
429 Too Many Requests |
Límite excedido | Se superaron las 60 solicitudes por minuto. |
500 Internal Error |
Error de servidor | Incidencia no controlada en el backend de Subflow. |
