Endpoints principales

La API está organizada por recursos, cada uno con sus propios endpoints. Aquí tienes un mapa de las áreas principales.

Inicio rápido

Tres fragmentos listos para llamar a la API externa. Reemplaza `yr_live_xxx` con tu clave personal (consulta la página «Claves API y autenticación»).

curl -X GET "https://api.yourang.ai.io/external/v1/contacts?limit=20" \
  -H "Authorization: Bearer yr_live_xxx" \
  -H "Accept: application/json"

Áreas de la API

• Contactos. Leer, crear, actualizar contactos del CRM. Sincronizaciones bidireccionales con sistemas de gestión, importaciones periódicas desde fuentes externas.
• Llamadas. Recuperar el historial de llamadas con metadatos, transcripciones y resúmenes. Disparar llamadas outbound de forma programática.
• Reservas. Crear, leer, modificar reservas. Sincronizar el calendario de yourang.ai con el PMS o gestor.
• Pedidos. Para el módulo Tienda: crear pedidos desde sistemas externos, leer el estado, recibir confirmaciones de pago.
• Documentos. Cargar y gestionar la base de conocimiento vía API. Útil para quien mantiene el catálogo/listado de precios en un sistema origen y quiere replicarlo en yourang.ai.
• Webhook. Configurar las URL a las que yourang.ai notifica eventos (ver página dedicada).

Casos de uso típicos

• Sync gestor → yourang.ai. Cada noche el PMS publica los nuevos contactos y las reservas del día en yourang.ai. El asistente de voz trabaja con datos siempre alineados.
• yourang.ai → gestor. Cuando el asistente registra una nueva reserva, la envía al gestor principal mediante API. El asistente se convierte en un canal de entrada al sistema central.
• Cuadro de mando a medida. Un BI o una hoja Excel conectada a la API muestra datos agregados personalizados, más allá de los del panel estándar.
• Automatizaciones con n8n / Make. Workflows no-code que reaccionan a eventos de yourang.ai para orquestar acciones en otros sistemas: Slack, Notion, Airtable.

Paginación y filtros

Todos los endpoints de listado soportan paginación (limit + offset) y filtros sobre los campos principales. Para exportaciones masivas conviene paginar con tamaños razonables (50-100 por página) en lugar de pedirlo todo de golpe: evita timeouts y carga sobre los sistemas.