Developers

API, webhooks y runtime listos para integrar

VANIA Web funciona como superficie de producto y VANIA Matrix como runtime central. Esta separacion permite evolucionar frontend sin comprometer la capa operativa.

Endpoints clave

POST /v1/chat
GET /v1/admin/connectors/catalog
GET|POST /v1/admin/connectors/installations
GET|POST /v1/admin/channels/routes
GET /v1/admin/channels/inbound-events
GET /v1/admin/connectors/delivery-receipts

Ejemplo webhook inbound

curl -i -X POST http://localhost:8787/v1/channels/webhooks/telegram?routeKey=default \
  -H "Content-Type: application/json" \
  -H "x-vania-installation-key: <INSTALLATION_KEY>" \
  -H "x-vania-installation-slug: <INSTALLATION_SLUG>" \
  -d '{
    "update_id": 90182,
    "message": {
      "message_id": 85,
      "text": "Necesito seguimiento de tickets en WhatsApp",
      "chat": { "id": "700123" },
      "from": { "id": "700123", "username": "cliente_demo" }
    }
  }'

Frontend desacoplado

Next.js expone API interna para proteger secretos y simplificar consumo.

Connector-first

Instalaciones y capacidades se gestionan por catalogo, no por hardcode de providers.

Observabilidad operativa

Health, inbound events y delivery receipts disponibles para monitoreo tecnico.

Ver integraciones Abrir documentacion