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.
¿Esta documentación fue útil para configurar tu integración?