API de BDC AI: inicio rápido

1. Crea una llave de API

En Ajustes, Integraciones, API y agentes (/settings/canales/api) crea una llave. El valor completo (bdc_live_…) se muestra una sola vez: guárdalo, porque después solo verás el key_hint.

2. Confirma la organización

Con la llave en Authorization: Bearer, cualquier request confirma a qué organización pertenece.

curl https://bdcai.com/api/v1/org \
  -H "Authorization: Bearer bdc_live_…"

3. Lee tus contactos

Listado paginado por cursor: data[] más next_cursor, nunca un arreglo suelto.

curl "https://bdcai.com/api/v1/contacts?limit=5" \
  -H "Authorization: Bearer bdc_live_…"

4. Inicia una conversación

conversations.start es síncrona: responde 201 con la conversación y el primer mensaje ya enviado. Las operaciones que crean algo llevan Idempotency-Key (UUID); un reintento con la misma llave y el mismo cuerpo re-sirve la respuesta original en vez de duplicar el envío.

curl -X POST https://bdcai.com/api/v1/conversations \
  -H "Authorization: Bearer bdc_live_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "dealership_id": "…",
    "phone": "+5218110000000",
    "first_name": "María",
    "contact_type": "venta",
    "template": {
      "name": "primer_contacto",
      "language": "es_MX"
    }
  }'

Conéctalo a tu agente

Todo lo de arriba también existe como servidor MCP (Model Context Protocol) en bdcai.com/mcp: las mismas 26 operaciones, expuestas como tools que un agente de IA puede llamar directo, con la misma autenticación y los mismos límites.

Ver las tres formas de conectar un agente.

Siguiente

• Autenticación, scopes, errores y límites: las reglas comunes a todas las operaciones.
• Webhooks: recibe un aviso firmado en vez de preguntar cada minuto.
• Referencia interactiva: Las 26 operaciones del contrato público, con parámetros, cuerpos y respuestas exactas, en un explorador interactivo generado desde nuestro propio OpenAPI 3.1, siempre al día con el código. También como OpenAPI 3.1 en JSON.