Empezando | InboundFlow Docs

Introducción

InboundFlow proporciona una API REST y Webhooks en tiempo real para integrar los datos de su asistente de voz en cualquier sistema. Use la API para extraer llamadas, contactos, clientes potenciales y citas. Use los webhooks para recibir notificaciones en tiempo real cuando sucedan eventos.

URL Base

https://api.inboundflow.app

Autenticación

Todas las solicitudes API requieren una clave API en el encabezado Authorization :

Header

Authorization: Bearer sk_live_your_key_here

Cómo obtener su clave API

Inicie sesión en su panel en secure.inboundflow.app
Vaya a Configuración → API (Settings → API)
Haga clic en "Generar Clave API"
Copie y almacene su clave de manera segura — no se mostrará de nuevo

Nota : Las claves se limitan a su organización. Los datos devueltos son exclusivamente de esta.

Límites de Ritmo

60 solicitudes por minuto por clave API
Encabezados de límite de ritmo en cada respuesta:

Response Headers

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58

Paginación

Los endpoints de lista admiten la paginación basada en punteros:

limit — resultados por página (por defecto: 50, máx: 100)
cursor — puntero opaco (desde next_cursor en la respuesta)
since — formato fecha-hora ISO

Formato de Respuesta

Todas las respuestas siguen un formato constante:

JSON

{
  "data": { ... },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-02-24T00:00:00Z"
  }
}

Los endpoints de lista incluyen información de paginación:

JSON

{
  "data": [...],
  "has_more": true,
  "next_cursor": "eyJjcmVhdGVkX2F0Ijo...",
  "meta": { ... }
}

Inicio Rápido: Obtener Llamadas Recientes

cURL

curl -X GET   "https://api.inboundflow.app/v1/calls?limit=5"   -H "Authorization: Bearer sk_live_your_key_here"   -H "Content-Type: application/json"

Respuesta

JSON

{
  "data": [
    {
      "id": "uuid",
      "caller_phone": "+1234567890",
      "caller_name": "Dave",
      "status": "completed",
      "duration_seconds": 55,
      "summary": "Called about auto repair appointment...",
      "started_at": "2026-02-24T20:59:00Z",
      "ended_at": "2026-02-24T21:00:00Z",
      "recording_url": "https://..."
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "meta": {
    "request_id": "req_abc123def456",
    "timestamp": "2026-02-24T00:00:00Z"
  }
}

Inicio Rápido: Obtener Contactos

cURL

curl -X GET   "https://api.inboundflow.app/v1/contacts?limit=5"   -H "Authorization: Bearer sk_live_your_key_here"

Manejo de Errores

Todos los errores devuelven un formato JSON uniforme:

JSON

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key",
    "status": 401
  },
  "meta": {
    "request_id": "req_abc123def456",
    "timestamp": "2026-02-24T00:00:00Z"
  }
}

Códigos de Error

Código	Definición
401	`unauthorized` Clave API faltante, inválida o expirada
400	`bad_request` Parámetros inválidos
404	`not_found` No encontrado
429	`rate_limited` Límite de solicitudes rebasado
500	`internal_error` Error del Servidor

Próximos Pasos

Referencia API →

Documentación y listado técnico

Webhooks →

Notificaciones HTTP