Canal

API de atención al cliente para integraciones y canales personalizados

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

API en detalle

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

Lo que obtienes con la atención por API

REST y webhooks

Lee y escribe conversaciones, contactos y mensajes, y recibe webhooks para eventos.

Reintentos seguros

Cada mensaje entrante lleva tu propio ID, así que una solicitud repetida nunca crea un duplicado.

Tokens de API con permisos

Cada token recibe solo los permisos que necesita una integración.

Especificación OpenAPI

La referencia completa está en /docs/api, con un archivo OpenAPI para Postman, Insomnia o tu propio generador de clientes.

Callbacks para respuestas

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

Listo en 3 pasos

  1. En el plan Enterprise, crea un token de API en Configuración → Tokens de API.
  2. Crea una bandeja de entrada de API REST y envía los mensajes de los clientes a su endpoint de entrada.
  3. Define una URL de callback para recibir las respuestas.

PREGUNTAS

Preguntas frecuentes

¿Cuál es la mejor API de atención al cliente para integraciones personalizadas?

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.

¿Cómo creo un canal personalizado con la API?

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.

¿La API de atención al cliente tiene límites de solicitudes?

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.

¿Qué eventos envían los webhooks?

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.

¿Puedo usar la API para migrar desde otro help desk?

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.

Pruébalo gratis
7 días

Empezar la prueba gratisGratis durante 7 días, para hasta 30 personas de tu equipo. Sin tarjeta de crédito.Ver precios

Demo interactiva de Deskwoot