REST y webhooks
Lee y escribe conversaciones, contactos y mensajes, y recibe webhooks para eventos.
Canal
La API de atención al cliente de Deskwoot cubre conversaciones, contactos, mensajes, agentes, etiquetas y atributos personalizados. Crea canales personalizados, chat dentro de tu app o el enrutamiento de alertas sobre la bandeja de entrada compartida.
Gratis durante 7 días, para hasta 30 personas de tu equipo. Sin tarjeta de crédito.
Resumen
Muchos help desks tratan la API como algo secundario y dejan fuera los endpoints que de verdad necesitas. La API de atención al cliente de Deskwoot viene con el plan Enterprise y cubre conversaciones, mensajes, contactos, bandejas de entrada, etiquetas, equipos, webhooks y más, todo documentado en una especificación OpenAPI.
REST y webhooks: conversaciones, contactos, mensajes, etiquetas, equipos, atributos personalizados y más están disponibles por REST. Los webhooks envían a tu URL eventos como conversación creada, asignada o resuelta, mensajes nuevos, cambios en contactos y valoraciones CSAT, firmados con tu secreto, para que tu código reaccione a los eventos en lugar de consultar una y otra vez. Con los tickets activados, los eventos de tickets también pueden llegar ahí.
Autenticación: tokens de API con permisos. Dale a cada integración solo lo que necesita, por ejemplo acceso de lectura, o el permiso específico que puede publicar mensajes de clientes en una bandeja de entrada de API.
Canales personalizados: crea una bandeja de entrada de API REST, envíale los mensajes de tus clientes con tu propio ID por mensaje y define una URL de callback. Una solicitud repetida nunca crea un duplicado, y las respuestas de los agentes y de Fynn se publican en tu URL de callback, así que el chat dentro de tu app o cualquier canal que no viene incluido funciona como los demás.
Usos comunes que vemos: 1) chat dentro de una app móvil, donde tu backend envía mensajes a una bandeja de entrada de API, 2) un formulario de contacto en tu sitio que abre una conversación a través de la API, 3) alertas de dispositivos o sistemas que llegan a la bandeja de entrada como conversaciones, 4) sincronizar contactos y datos de conversaciones con tus propios sistemas.
Lo que obtienes
Lee y escribe conversaciones, contactos y mensajes, y recibe webhooks para eventos.
Cada mensaje entrante lleva tu propio ID, así que una solicitud repetida nunca crea un duplicado.
Cada token recibe solo los permisos que necesita una integración.
La referencia completa está en /docs/api, con un archivo OpenAPI para Postman, Insomnia o tu propio generador de clientes.
Define una URL de callback en la bandeja de entrada de API y las respuestas de los agentes y de Fynn se publican en tu sistema.
Cómo conectarlo
PREGUNTAS
Para canales personalizados, la API de atención al cliente necesita: endpoints para conversaciones y contactos, webhooks para eventos, tokens con permisos, reintentos seguros y buena documentación. Deskwoot tiene todo esto en el plan Enterprise, con una especificación OpenAPI. Zendesk e Intercom también tienen API sólidas.
Crea una bandeja de entrada de API REST en Configuración → Bandejas de entrada con una URL de callback. Envía los mensajes de los clientes a https://api.deskwoot.com/v1/accounts/{accountId}/inbound con un token que tenga el permiso inbound:ingest, y las respuestas de los agentes y de Fynn se envían a tu URL de callback. Deskwoot se encarga de la bandeja de entrada, la IA, los SLA y los informes.
Sí. Las solicitudes tienen un límite por token, por ejemplo 120 mensajes entrantes por minuto, y una solicitud que pasa el límite recibe una respuesta 429.
Los webhooks cubren los eventos principales: conversación creada, actualizada, asignada y resuelta, mensaje creado, contacto creado y actualizado, y CSAT enviado. Con los tickets activados, un webhook también puede recibir ticket creado, actualizado, asignado y resuelto. Cada envío va firmado con tu secreto de webhook y se reintenta una vez si tu endpoint falla.
Para la mayoría de las migraciones no necesitas la API: Configuración → Importación trae contactos y conversaciones de Chatwoot, Zendesk, Freshdesk, Intercom y Crisp, y una importación CSV cubre contactos de cualquier otro lugar. La API ayuda con datos de otros sistemas.
Relacionados