Documentación para desarrolladores
Todo lo que necesitas para conectar Deskwoot con tus herramientas. Pon el widget de chat en tu sitio o controla conversaciones, contactos y bandejas de entrada desde tu backend.
La API REST permite que tus propios sistemas creen y respondan conversaciones, gestionen contactos y atributos personalizados, y reaccionen a eventos de webhook. Te autenticas con un bearer token de Configuración → Tokens de API. Cada token tiene sus propios permisos, así que una tarea de informes puede tener acceso de lectura mientras la integración de tu back office tiene acceso de escritura. Los tokens de API forman parte del plan Enterprise.
El widget de JavaScript pone el chat en vivo de Deskwoot en tu sitio web. Es una etiqueta script más un pequeño objeto de configuración, y trae mensajes en tiempo real, archivos adjuntos, inicio de sesión verificado para tus usuarios con sesión iniciada y Fynn, nuestro agente de IA. Para tener más control, como abrir el chat desde tu propio botón o iniciar la sesión de un usuario después de que la página cargó, el cargador agrega una pequeña API en window.deskwoot.
¿Eres nuevo? Empieza con el widget: es un solo fragmento de código en la plantilla de tu página. Pasa a la API REST cuando quieras sincronizar datos del CRM o abrir conversaciones desde tus propias apps.
Widget de chat en JavaScript
Pon el chat en vivo de Deskwoot en tu sitio web. Pega un fragmento de código, verifica a los usuarios con sesión iniciada y abre el chat desde tus propios botones.
- Fragmento de inserción
- Opciones de configuración
- API de JavaScript
- Verificación de identidad
- Notas sobre CSP
API REST
Acceso por código a conversaciones, contactos, bandejas de entrada, equipos y más. Autentícate con un token de API y controla Deskwoot desde tu backend.
- Autenticación
- Conversaciones
- Contactos
- Bandejas de entrada
- Webhooks
Relacionado en el panel
Algunas integraciones se configuran directamente en tu panel de Deskwoot:
- Configuración → Webhooks
- Suscríbete a eventos de conversaciones, mensajes y contactos mediante callbacks HTTP.
- Configuración → Integraciones
- Conecta Shopify, Stripe y WooCommerce, publica alertas en Slack y envía eventos a miles de otras apps a través de Zapier.
- Configuración → Tokens de API
- Crea tokens con sus propios permisos para la API REST.
¿Te falta una integración o necesitas ayuda para conectar algo? Escríbenos a hello@deskwoot.com.
Preguntas frecuentes
Aquí tienes las respuestas cortas. Para todo lo demás, pregúntale a Fynn abajo.
¿Deskwoot tiene una API REST?
Sí. La API REST cubre conversaciones, mensajes, contactos, bandejas de entrada, agentes, equipos, etiquetas, atributos personalizados, reglas de automatización, webhooks y artículos del centro de ayuda. La referencia completa con ejemplos de curl está en deskwoot.com/docs/api. Los tokens de API forman parte del plan Enterprise.
¿Cómo autentico las solicitudes a la API?
Crea un token en Configuración → Tokens de API y envíalo como bearer token en el encabezado Authorization de cada solicitud. Cada token pertenece a un espacio de trabajo, tiene sus propios permisos (como read, write o contacts:read) y puedes revocarlo en cualquier momento sin afectar tus otros tokens.
¿Hay webhooks para conversaciones y mensajes nuevos?
Sí. Deskwoot envía webhooks cuando una conversación se crea, se actualiza, se asigna o se resuelve, cuando se crea un mensaje, cuando un contacto se crea o se actualiza, y cuando se envía una encuesta CSAT. Agregas las URL de webhook para todo el espacio de trabajo en Configuración → Webhooks y eliges los eventos de cada URL. Cada entrega lleva un encabezado X-Deskwoot-Signature (HMAC SHA256), para que puedas comprobar que viene de nosotros.
¿Hay una especificación OpenAPI o una colección de Postman?
Sí. La especificación OpenAPI 3.1 está publicada en deskwoot.com/openapi.yaml. Impórtala en Postman, Insomnia o cualquier otra herramienta OpenAPI para explorar los endpoints o generar un cliente en tu lenguaje.