Chat2Desk OnCloud para desarrolladores
Integra Chat2Desk OnCloud con tu producto, tu CRM o tus sistemas internos. Con la API, los webhooks, el canal externo, el SDK móvil y los scripts en Python puedes enviar y recibir mensajes de WhatsApp y de otros canales, reaccionar a lo que ocurre en tus conversaciones en tiempo real, llevar el chat a tu propia aplicación y automatizar reglas dentro de la plataforma.
Esta página te ayuda a elegir por dónde empezar. Cada forma de integrar tiene su propia guía, con el detalle técnico.
En resumen
- API REST para enviar y recibir mensajes y administrar clientes, diálogos, operadores, etiquetas, plantillas y tickets.
- Webhooks firmados para enterarte al instante de cada evento.
- Canal externo para integrar como canal de Chat2Desk cualquier canal de mensajería que no sea nativo: la mensajería de tu app, un portal o el sistema que uses.
- SDK para iOS y Android para incrustar el chat en tu app, con mensajes disponibles sin conexión.
- Scripts en Python que se ejecutan en Chat2Desk, sin servidor propio, para repartir chats y reaccionar a eventos.
En esta página: Guías · Qué puedes construir · Elige cómo integrar · Cómo empezar · Seguridad · Preguntas frecuentes
Guías para desarrolladores
| Guía | Qué encontrarás | Ir a la guía |
|---|---|---|
| API de Chat2Desk OnCloud | URL base y autenticación, más de 70 operaciones agrupadas por recurso, webhooks con verificación de firma, canal externo, límites y buenas prácticas | Ver la guía de la API |
| Canal externo | Cómo integrar cualquier canal de mensajería que no sea nativo: activación con soporte, mensajes entrantes por API, respuestas por webhook y estados de entrega | Ver la guía del canal externo |
| SDK móvil para iOS y Android | Instalación con Swift Package Manager y Maven Central, inicialización, mensajes y búsqueda, modo sin conexión, repositorios y apps de ejemplo | Ver la guía del SDK móvil |
| Scripts en Python | Cómo activarlos, los 14 eventos que los disparan, los 20 comandos disponibles y ejemplos de uso | Ver la guía de scripts |
| Chatbots Conversacionales | Cómo crear un chatbot, atraer clientes con un inicio por enlace, integrarlo con tu sistema por solicitudes HTTP y recibir eventos con activadores (documentación en preparación) | Ver la guía de chatbots |
Qué puedes construir
- Conectar tu CRM, tu ERP o tu sistema interno con tus conversaciones: envía y recibe mensajes de WhatsApp y de otros canales desde tu propio software.
- Integrar cualquier canal de mensajería que Chat2Desk no soporte de forma nativa, como la mensajería de tu app o de tu portal, con el canal externo: tus operadores lo atienden junto con WhatsApp y los demás canales.
- Dar soporte dentro de tu app con operadores que trabajan en Chat2Desk, con el canal externo o con el SDK móvil.
- Enviar notificaciones a tus clientes, como confirmaciones y avisos, con la API.
- Reaccionar en tiempo real a un mensaje nuevo, un diálogo cerrado, una etiqueta o un ticket mediante webhooks.
- Automatizar reglas dentro de Chat2Desk con scripts: repartir chats entre operadores, avisar a un supervisor de chats vencidos o enviar un WhatsApp después de una llamada.
- Exportar clientes y estadísticas a tu CRM o a tus tableros.
Elige cómo integrar
| Necesitas… | Usa | Dónde empezar |
|---|---|---|
| Enviar y recibir mensajes, consultar clientes, diálogos, operadores o tickets desde tu servidor | API REST | Primeros pasos con la API |
| Enterarte al instante de un mensaje nuevo, un cambio de diálogo o un ticket | Webhooks | Webhooks |
| Integrar como canal de Chat2Desk cualquier canal de mensajería que no sea nativo (la mensajería de tu app, tu portal u otro sistema) | Canal externo | Guía del canal externo |
| Poner el chat dentro de tu app móvil | SDK iOS y Android | Guía del SDK móvil |
| Programar reglas dentro de Chat2Desk, sin servidor propio: repartir chats, avisar a un supervisor o reaccionar a eventos | Scripts en Python | Guía de scripts |
| Conversar con tus clientes con un chatbot que se integra con tu sistema por solicitudes HTTP y activadores | Chatbots Conversacionales | Guía de chatbots |
Antes de integrar, necesitas una cuenta de Chat2Desk. Si todavía no la tienes, regístrate gratis. Para entender cómo se conecta WhatsApp a la plataforma (Cloud API de Meta o 360dialog), consulta la guía de WhatsApp Business API con Chat2Desk OnCloud y las tarifas vigentes.
Cómo empezar
- Crea tu cuenta de Chat2Desk y conecta al menos un canal.
- Elige la guía que corresponde a lo que quieres construir (tabla anterior).
- Reúne tus credenciales. Para la API, los webhooks y el canal externo, tu token está en API & Scripts > API (con un usuario administrador). Para el SDK móvil necesitas los valores de un canal de Widget y chat en línea. Los scripts los activa la administración de Chat2Desk a solicitud.
- Prueba antes de programar. Abre la colección de la API en Postman y lanza tus primeras solicitudes.
También puedes consultar la referencia completa de la API.
Seguridad
- Tu token es un secreto: no lo pongas en código de cliente ni en repositorios públicos, y no lo compartas en tickets de soporte.
- Los webhooks van firmados con HMAC-SHA256: verifica la firma antes de confiar en el contenido.
- Usa
httpsen la dirección de tus webhooks. - Consulta también la guía de administración de claves API y nuestra página de seguridad de la información.
Preguntas frecuentes
¿Qué puedo integrar con Chat2Desk OnCloud? Tu CRM, tu ERP, tu app móvil, tus sistemas de telefonía y cualquier sistema que pueda llamar a una API web o recibir un webhook.
¿Puedo integrar un canal de mensajería que Chat2Desk no soporta? Sí, con el canal externo: soporte técnico crea un canal con ese transporte habilitado y tu sistema envía y recibe los mensajes por API y webhooks.
¿Hay un entorno de pruebas? No. Para probar se crean canales y transportes de prueba.
¿Necesito un servidor propio? Para la API, los webhooks y el canal externo, sí: las llamadas salen de tu servidor. Los scripts en Python se ejecutan en Chat2Desk y no lo necesitan.
¿Dónde obtengo mi token de la API? En tu cuenta, con un usuario administrador, en API & Scripts > API.
¿Dónde está la documentación completa de cada endpoint? En la referencia de la API en Postman, y resumida por recurso en la guía de la API.
¿Puedo llevar el chat a mi app móvil? Sí, con el SDK para iOS y Android.
¿Puedo automatizar sin programar un servidor? Sí, con los scripts en Python, que se guardan y se ejecutan en Chat2Desk.
¿Necesitas ayuda con tu integración?
Cuéntanos qué quieres conectar y te orientamos. Si todavía no tienes cuenta, empieza con la prueba gratuita.
