Integraciones · API REST
API REST documentada, versionada, idempotente
Cada endpoint sigue convención Stripe/Twilio: paginación cursor, idempotency key obligatoria en POST, errores estructurados.
Autenticación por Bearer token
integrations.api.sections.authText
Endpoints principales
Conversations, messages, departments, categories, macros, hold reasons, SLA configs, message templates, KB, FAQ, tags, operator status, webhook endpoints, audit log.
Versionado
Ruta /v1/ fija. v2 cuando llegue coexiste con v1 por 12 meses mínimo, con header Sunset (RFC 8594) comenzando 6 meses antes.
Ejemplo: crear conversación
bash
curl https://api.vaidesk.com/v1/conversations \
-X POST \
-H "Authorization: Bearer vd_live_a3b1f7e2_4f8a9c2d..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 8e3a..." \
-d '{
"external_user_id": "user_123",
"subject": "Question about plan",
"initiated_by_side": "end_user"
}'¿Listo para integrar atención al cliente robusta en su producto?
Cuéntenos sobre su caso. Respondemos en un día hábil.