Otros canales

¿Cómo configurar un canal de Facebook?

Si estás utilizando una instalación autoalojada de Chatwoot, configura tu aplicación de Facebook como se describe en esta guía. Para la versión cloud de Chatwoot, sigue los pasos a continuación. Paso 1. Ve a Configuración → Bandejas de entrada → “Agregar bandeja de entrada”. Paso 2. Haz clic en el icono de "Messenger". Paso 3. Haz clic en el botón de inicio de sesión de Facebook. Se abrirá una nueva ventana para que inicies sesión. Paso 4. Autentícate con Facebook y selecciona la página que deseas conectar. Habilita todos los permisos que aparecen en la lista. Esto ayudará a que Chatwoot realice todas las acciones deseadas sin problemas. Paso 5. Ahora puedes seleccionar tu página de Facebook desde el menú desplegable que aparece en Chatwoot. Paso 6. "Agrega agentes" a tu bandeja de Facebook. Has creado exitosamente una bandeja de entrada de Facebook. Cada vez que un cliente envíe un mensaje a tu página de Facebook, podrás verlo y responderlo desde Chatwoot. Configuración adicional de bandeja de entrada​ Tu bandeja de Facebook recién configurada ahora debería aparecer en tu lista de bandejas de entrada. Para ver esto y hacer ajustes adicionales en tu bandeja de Facebook, ve a Configuración → Bandejas de entrada → haz clic en el icono de engranaje de la bandeja asociada de Facebook. Verás la siguiente pantalla: Pestaña de configuración​ Habilitar saludo del canal. Una vez que actives esto, Chatwoot enviará un mensaje de bienvenida a las nuevas conversaciones creadas a través de tu bandeja de Facebook. Habilitar CSAT. Una vez que actives esto, tu encuesta de satisfacción del cliente se lanzará cada vez que se resuelva un ticket. Los resultados de CSAT pueden ser vistos más tarde en la sección de Informes. Reautorizar. Siempre que necesites reconectar y reautorizar tu página de Facebook, hazlo desde este botón. Pestaña de colaboradores​ Haz clic en la pestaña Colaboradores. Aquí puedes agregar agentes a la bandeja de entrada o eliminar agentes que ya hayan sido añadidos en la bandeja. También puedes habilitar o deshabilitar la asignación automática de nuevas conversaciones a los agentes añadidos a esta bandeja. Haz clic en Actualizar para guardar los cambios. Pestaña de horario comercial​ Haz clic en la pestaña Horario Comercial. En esta sección, puedes establecer el horario laboral de tu equipo asociado a la bandeja de Facebook. Haz clic en la casilla para Habilitar disponibilidad comercial para esta bandeja si tienes un horario comercial bien definido. Una vez seleccionada la casilla, se abrirá la sección inferior. Puedes escribir el mensaje que se mostrará al cliente durante el horario NO laboral. Nota: Cuando Captain está habilitado en una bandeja, el mensaje de no disponibilidad se suprime automáticamente. Captain gestionará las conversaciones directamente, incluso fuera del horario comercial. Solo se enviará el mensaje de no disponibilidad si Captain transfiere la conversación a un agente humano o si Captain no está configurado para la bandeja. También puedes seleccionar el horario disponible para cada día de la semana, junto con la zona horaria correspondiente. Haz clic en el botón Actualizar configuración de horario comercial.

¿Cómo configurar un canal de Instagram (a través del inicio de sesión de Facebook)?

Recomendamos el inicio de sesión empresarial de Instagram como el método de autenticación preferido, ya que proporciona una configuración más simple y una mejor experiencia para el desarrollador. Por favor, consulta esta guía para más detalles. Dejaremos de dar soporte a Instagram a través del inicio de sesión de Facebook en el futuro, a partir de la versión v4.1 en adelante. Si estás utilizando una instalación autohospedada de Chatwoot, por favor configura tu aplicación de Instagram como se describe en esta guía. Para la versión en la nube de Chatwoot, sigue esta guía. Requisitos previos Antes de traer tu bandeja de entrada de Instagram a Chatwoot, debes asegurarte de que tienes una cuenta de Instagram empresarial. Paso 1. Configura una cuenta de Instagram empresarial si aún no tienes una. Esta guía de Instagram te ayudará a hacerlo. Paso 2. Asegúrate de que tu página de Facebook esté conectada a esta cuenta de Instagram. Para conectar Facebook e Instagram, sigue estos pasos: 1. Ve a https://www.facebook.com/pages/?category=your_pages. 2. Selecciona Tu Página. 3. Ve a Configuración. 4. Selecciona “Instagram” y conecta tu cuenta empresarial como se muestra a continuación: Ahora regresa a la aplicación de Chatwoot. ¿Cómo crear una bandeja de entrada de Instagram en Chatwoot? Paso 1. Ve a Configuración → Bandejas de entrada → “Agregar bandeja de entrada”. Paso 2. Haz clic en el ícono de "Messenger". Paso 3. Haz clic en el botón de inicio de sesión de Facebook. Se abrirá una nueva ventana para que inicies sesión. Paso 4. Autentícate con Facebook, selecciona una cuenta de Instagram y selecciona la página que deseas conectar. Habilita todos los permisos que aparecen en la lista. Esto ayudará a Chatwoot a realizar todas las acciones deseadas sin inconvenientes. Paso 5. "Agregar agentes" a tu bandeja de entrada de Instagram. Has creado exitosamente una bandeja de entrada de Instagram. Cada vez que un cliente envíe un mensaje a tu cuenta de Instagram, podrás verlo y responderlo en Chatwoot.

¿Cómo crear un canal en Twitter?

NOTA: La integración con Twitter ha sido temporalmente suspendida como resultado de modificaciones hechas por Twitter en sus APIs. Esto incluye limitaciones en el número de solicitudes permitidas por minuto, además de importantes cambios en los precios. Con una bandeja de entrada de Twitter, puedes gestionar tanto los tuits que te mencionan como tus mensajes directos de Twitter desde Chatwoot. Si estás utilizando una instalación autoalojada de Chatwoot, por favor configura tu bandeja de entrada de Twitter como se describe en esta guía. Para la versión en la nube de Chatwoot, sigue los pasos a continuación. Paso 1. Ve a Configuración → Bandejas de entrada → “Agregar bandeja de entrada”. Paso 2. Haz clic en el ícono de "Twitter". Paso 3. Haz clic en el botón "Iniciar sesión con Twitter". Paso 4. Serás redirigido a Twitter. Haz clic en el botón "Autorizar aplicación". Paso 5. "Agrega agentes" a tu bandeja de entrada de Twitter. Has creado exitosamente una bandeja de entrada de Twitter. Ahora podrás gestionar tanto los mensajes directos de Twitter como los tuits que te mencionan desde Chatwoot. Configuración adicional de la bandeja de entrada​ Tu bandeja de entrada de Twitter recién configurada ahora debería aparecer en tu lista de bandejas de entrada. Para ver esto y realizar configuraciones adicionales en tu bandeja de entrada de Twitter, ve a Configuración → Bandejas de entrada → haz clic en el ícono de engranaje en la bandeja de entrada de Twitter correspondiente. Verás la siguiente pantalla: Aquí puedes realizar algunos cambios fundamentales. Pestaña de configuración​ Activar saludo del canal. Una vez que actives esta opción, Chatwoot enviará un mensaje de saludo a las nuevas conversaciones creadas a través de tu bandeja de entrada de Twitter. Activar CSAT. Una vez que habilites esta opción, tu encuesta de Satisfacción del Cliente se lanzará cada vez que se resuelva un ticket. Los resultados de CSAT pueden verse después en la sección de Informes. Pestaña de colaboradores​ Haz clic en la pestaña Colaboradores. Aquí puedes agregar agentes a la bandeja de entrada o eliminar agentes que ya han sido añadidos. También puedes activar o desactivar la asignación automática de nuevas conversaciones a los agentes añadidos en esta bandeja de entrada. Haz clic en Actualizar para guardar los cambios. Pestaña de horario laboral​ Haz clic en la pestaña Horario laboral. En esta sección, puedes establecer el horario de trabajo de tu equipo asociado con la bandeja de entrada de Twitter. Marca la casilla Habilitar disponibilidad comercial para esta bandeja de entrada si tienes horarios definidos de atención. Una vez que la casilla esté marcada, se abrirá la sección inferior. Puedes escribir tu mensaje para mostrar al cliente durante los horarios FUERA de atención. También puedes seleccionar los horarios comerciales disponibles para cada día de la semana y la zona horaria correspondiente. Haz clic en el botón Actualizar configuración de horario comercial.

¿Cómo configurar un canal de WhatsApp?

Puedes gestionar las conversaciones de tu Cuenta de WhatsApp Business directamente desde Chatwoot. Para conectar tu número de WhatsApp, Chatwoot admite dos métodos de integración: - Registro Integrado (recomendado) – un flujo guiado impulsado por Meta que configura automáticamente tu número, webhooks y tokens. - Configuración Manual – una opción avanzada para proveedores tecnológicos y casos donde no se puede utilizar el Registro Integrado. Esta guía te ofrece una visión general de ambos métodos, sus diferencias y enlaces a instrucciones detalladas paso a paso. Requisitos previos - Una cuenta de desarrollador o empresa de Meta (Facebook) - Un número de teléfono válido (que no esté ya vinculado a otro flujo de Registro Integrado de WhatsApp, salvo que estés migrando) - Un espacio de trabajo en Chatwoot con la función de WhatsApp habilitada Paso 1: Ve a Bandejas de Entrada 1. Inicia sesión en tu cuenta de Chatwoot. 2. Navega a Configuración › Bandejas de Entrada › Agregar Bandeja de Entrada. 3. Elige WhatsApp como el canal. Paso 2: Elige tu Método de Configuración Al crear una Bandeja de Entrada de WhatsApp, verás dos opciones: Conectar con WhatsApp Business (Registro Integrado) - Te redirige al flujo de Registro Integrado de Meta. - Inicias sesión con tu cuenta de Facebook, seleccionas o creas una Cuenta de WhatsApp Business (WABA) y agregas tu número de teléfono. - Chatwoot recibe automáticamente la configuración del webhook, los tokens y tu número de teléfono. Utiliza esta opción si: - Estás agregando un nuevo número de WhatsApp - Buscas la configuración más rápida y sin complicaciones - No eres un proveedor tecnológico integrando tu propio número Lee la guía completa sobre Registro Integrado de WhatsApp Configuración Manual - Tú configuras todo a través de la Consola de Desarrolladores de Meta. - Requiere generar tokens, crear un usuario del sistema, asignar activos y configurar webhooks manualmente. - Copias y pegas el ID de Número de Teléfono, ID de Cuenta de Negocio y clave API en Chatwoot. Utiliza esta opción si: - Eres un proveedor tecnológico integrando tu propio número - Estás reutilizando un número que ya está vinculado al Registro Integrado - Te sientes cómodo trabajando con el panel de desarrolladores de Meta Lee la guía completa sobre Configuración Manual

¿Cómo configurar un canal de SMS?

Puedes configurar tu bandeja de entrada del canal SMS a través de dos proveedores: 1. Twilio 2. Bandwidth Creando una bandeja de entrada SMS Sigue los pasos a continuación. Paso 1. Abre tu panel de Chatwoot. Ve a Configuración → Bandejas de entrada → Agregar bandeja de entrada. Paso 2. Haz clic en el icono "SMS". Paso 3. Elige tu proveedor de API y configura la bandeja de entrada. A continuación se explican ambas opciones. Elegir "Twilio" como proveedor de API Si deseas usar Twilio para configurar tu bandeja de entrada SMS, selecciónalo del menú desplegable. Se mostrarán los campos requeridos como se explica abajo. Estos son los datos requeridos para crear este canal: Haz clic en Create Twilio Channel después de completar la información. Configurar Chatwoot con Twilio Studio​ Si usas Twilio Studio para un flujo de conversación personalizado, actualizar la URL del webhook directamente romperá tu integración existente. En estos casos, puedes ir a la sección "Twilio Studio" en este documento. Elegir "Bandwidth" como proveedor de API Si deseas usar Bandwidth para configurar tu bandeja de entrada SMS, selecciónalo del menú desplegable. Se mostrarán los campos requeridos como se muestra abajo. Haz clic en Create Bandwidth Channel después de completar la información. Una vez que hayas terminado este paso, procede a agregar agentes. Paso 4. "Agrega agentes" a tu bandeja de entrada. Has creado exitosamente una bandeja de entrada SMS. Comenzarás a recibir los mensajes en tu panel de Chatwoot. También puedes ver: Enviar una campaña SMS a un grupo de contactos.

¿Cómo configurar un canal de correo electrónico?

Para gestionar tu correo de soporte al cliente/sistema de tickets desde Chatwoot, puedes crear una Bandeja de entrada de correo electrónico en Chatwoot. Esta es una guía completa para poner en marcha tu canal de correo electrónico. Este documento está dividido en tres partes: 1. Creando una bandeja de entrada de correo electrónico 2. Configuración para usuarios de Gmail 3. Creación de una bandeja de entrada de correo Microsoft Siéntete libre de pasar a cualquier sección. Vamos allá. ¿Cómo crear una bandeja de entrada de correo electrónico en Chatwoot? Paso 1. Abre tu panel de Chatwoot. Ve a Configuración → Bandejas de entrada → Añadir Bandeja de entrada. Paso 2. Haz clic en el ícono "Email". Paso 3. Ingresa el nombre del canal (cómo te gustaría nombrar este canal), tu correo de soporte y haz clic en el botón "Crear canal de correo electrónico". P.D. También verás una opción para seleccionar Microsoft como proveedor de correo. Si usas un correo de Outlook/Microsoft, ve a la sección "¿Cómo crear un canal de correo electrónico de Microsoft?" (última sección). Paso 4. "Agregar agentes" a tu bandeja de entrada de email. Has creado exitosamente una bandeja de entrada de correo electrónico. Paso 5. Configura los ajustes de tu correo electrónico. Ve a Configuración → Bandejas de entrada → Configuración de la bandeja de entrada de email → pestaña Configuración. Verás tres configuraciones principales aquí: 1. Reenviar a correo electrónico 2. Configurar IMAP 3. Configurar SMTP Las tres configuraciones se explican en las siguientes secciones. ¿Cómo reenviar correos electrónicos a la bandeja de entrada de Chatwoot? Paso 1. Copia la dirección de "Reenviar a correo electrónico" desde la pestaña Configuración dentro de Configuración de bandeja de entrada. Paso 2. Configura la dirección de correo copiada como la dirección de reenvío en la bandeja de entrada del correo. P.D. Consulta la sección de Gmail abajo para saber cómo agregar una dirección de reenvío en Gmail. Paso 3. Envía un correo al inbox de la dirección de reenvío agregada y comprueba el nuevo correo en la bandeja de entrada de Chatwoot. ¿Cómo configurar IMAP para el canal de correo? Si estás usando Gmail, desplázate hacia abajo a la sección IMAP para Gmail. Paso 1. Ve a Configuración → Bandejas de entrada → Configuración de la bandeja de entrada de correo electrónico → pestaña Configuración. Paso 2. Selecciona la casilla Habilitar configuración IMAP para esta bandeja de entrada. Podrás ver los campos requeridos a continuación. 1. Dirección 2. Puerto 3. Correo electrónico 4. Contraseña P.D. Si usas Gmail con 2FA habilitada, ve a la sección "¿Cómo generar contraseña de aplicación para Gmail?" Si usas una cuenta de Gmail regular, ve a la sección "¿Cómo permitir acceso menos seguro a Gmail?". Paso 3. Prueba si todo funciona correctamente. Envía un correo electrónico al correo configurado con IMAP en Chatwoot. Comprueba la bandeja de entrada de Chatwoot para ver el nuevo correo. Abre la conversación en Chatwoot y verifica los detalles del correo. ¿Cómo configurar SMTP para el canal de correo? Paso 1. Ve a Configuración -> Bandejas de entrada -> página de configuración de la bandeja de entrada de email. Paso 2. Selecciona la pestaña "Configuración". Paso 3. Para habilitar SMTP, selecciona la casilla "Habilitar configuración SMTP para esta bandeja de entrada". Completa los siguientes campos y haz clic en el botón "Actualizar configuración SMTP". 1. Dirección 2. Puerto 3. Correo electrónico 4. Contraseña P.D. Si usas Gmail con 2FA habilitada, ve a la sección "¿Cómo generar contraseña de aplicación para Gmail?" Si usas una cuenta de Gmail regular, ve a la sección "¿Cómo permitir acceso menos seguro a Gmail?". 5. Dominio Paso 4. Abre una conversación de correo ya existente en Chatwoot. Paso 5. Escribe tu respuesta y haz clic en "Enviar". Verifica que el correo haya sido entregado. También puedes comprobar la bandeja de entrada del destinatario para verificar que se entregó el correo. Configuración para usuarios de Gmail ¿Cómo habilitar IMAP para la bandeja de entrada de Gmail? Paso 1. Abre tu bandeja de entrada de Gmail y haz clic en el ícono de Configuración en la parte superior derecha. Haz clic en "Ver toda la configuración". Paso 2. Selecciona la pestaña "Reenvío y correo POP/IMAP" en la página de configuración. Paso 3. Elige la opción "Habilitar IMAP" en la sección acceso IMAP y haz clic en el botón "Guardar cambios". ¿Cómo permitir acceso menos seguro a Gmail? Nota: Esta opción no está disponible para cuentas de Gmail con verificación en dos pasos habilitada o gestionadas por una organización. Paso 1. Ve a Google Account Security. Paso 2. Haz clic en "Activar acceso" bajo la sección "Acceso de aplicaciones menos seguras" en la página de Seguridad. Paso 3. Activa "Permitir aplicaciones menos seguras". Ahora puedes usar la contraseña de tu cuenta de Gmail para configurar IMAP/SMTP. ¿Cómo generar contraseña de aplicación para Gmail? Nota: Esta opción es para cuentas de Gmail con verificación en dos pasos habilitada o gestionadas por una organización. Paso 1. Ve a Google Account Security. Paso 2. Haz clic en "Contraseñas de aplicaciones" bajo la sección "Acceso a Google" en la página de Seguridad. Paso 3. Selecciona la aplicación Mail, selecciona un dispositivo y haz clic en "GENERAR". Usa la contraseña generada para configurar IMAP/SMTP. ¿Cómo agregar una dirección de reenvío para Gmail? Paso 1. Abre tu bandeja de entrada de Gmail y haz clic en el ícono de Configuración en la parte superior derecha. Haz clic en "Ver toda la configuración". Paso 2. Selecciona la pestaña "Reenvío y correo POP/IMAP" en la página de configuración. Paso 3. Haz clic en el botón "Agregar una dirección de reenvío". Te pedirá la dirección de correo de reenvío. Ingresa la de Chatwoot y haz clic en el botón "Siguiente". Paso 4. Confirma la dirección de reenvío en la ventana emergente del navegador. El correo enviará un código de verificación a la dirección de reenvío. Paso 5. Copia el código de verificación de la bandeja de entrada de correo de Chatwoot. Paso 6. Pega el código de verificación y haz clic en el botón "Verificar". Paso 7. Selecciona la opción "Reenviar una copia del correo entrante". Elige la acción requerida en el segundo menú desplegable y haz clic en "Guardar cambios". ¿Cómo crear un canal de correo electrónico de Microsoft? Paso 1. Abre tu panel de Chatwoot. Ve a Configuración → Bandejas de entrada → Añadir Bandeja de entrada. Paso 2. Haz clic en el ícono "Email". Paso 3. Haz clic en el ícono "Microsoft". Paso 4. Agrega tu correo electrónico de Outlook/Microsoft. Paso 5. Ingresa tus credenciales de Microsoft/Outlook. Paso 6. Permite que la aplicación "Chatwoot" lea y responda tus correos electrónicos. Paso 7. "Agregar agentes" a tu bandeja de entrada de correo electrónico. Has creado exitosamente una bandeja de entrada de correo Microsoft. Paso 5. Configura los ajustes de tu correo electrónico. Ve a Configuración → Bandejas de entrada → Configuración de la bandeja de entrada de correo electrónico → pestaña Configuración. Nota: Por favor, no cambies nada en Configuración por ahora, ya que hemos utilizado los valores predeterminados para IMAP y SMTP. Pronto haremos que estos campos no se puedan editar para cuentas de Outlook. Usamos la configuración IMAP predeterminada para obtener emails y SMTP para enviar; no necesitas configurar nada a través de la configuración. Paso 6. Si tu token de acceso expira, deberás volver a autorizar tu cuenta de Microsoft yendo a Configuración -> Configuración.

¿Cómo crear un canal de Telegram?

Paso 1. Ve a Configuración → Bandejas de entrada → “Agregar bandeja de entrada”. Paso 2. Haz clic en el icono de "Telegram". Paso 3. Crea un nuevo bot de Telegram usando BotFather de Telegram. Paso 4. Ingresa el token de API del bot de Telegram y haz clic en "Crear canal de Telegram". Paso 5. "Agrega agentes" a tu bandeja de entrada de Telegram. La configuración de la bandeja de entrada está completa. Paso 6. Ve a la página de configuración de la bandeja de entrada y verifica que el nombre de la bandeja coincide con el nombre de usuario del bot creado usando BotFather. Paso 7. Envía un mensaje al bot de Telegram. Revisa la bandeja de entrada de Telegram en Chatwoot para ver el mensaje nuevo. Preguntas frecuentes ¿Chatwoot es compatible con cuentas de Bot Empresarial de Telegram? Sí — el soporte para bots en modo empresarial de Telegram fue añadido en Chatwoot v4.3.0 (18 de junio, 2025). ¿Cómo habilitar Bots Empresariales? 1. En @BotFather ejecuta /business_mode, elige tu bot y confirma. 2. Crea una nueva bandeja de entrada de Telegram en Chatwoot (Configuración → Bandejas de entrada → Agregar bandeja de entrada → Telegram) y pega el mismo token del bot. 3. Chatwoot detecta automáticamente el Modo Empresarial y registra el webhook correcto. 4. Para mejores resultados, mantén este bot empresarial en su propia bandeja de entrada, separado de cualquier bot estándar que ya uses.  Problemas conocidos con el Bot Empresarial • Ventana de respuesta de 24 horas – Telegram solo permite que el bot (y Chatwoot) respondan dentro de las 24 horas posteriores al último mensaje del cliente.  • Si un usuario ha conversado previamente con el mismo bot fuera del Modo Empresarial, las respuestas pueden parecer enviadas por el bot en lugar de la cuenta empresarial; crear un bot empresarial e inbox dedicados evita esta confusión. • La API Empresarial de Telegram actualmente tiene menos funciones que la API regular de bots (por ejemplo, sin indicadores de escritura, tipos de mensajes limitados). Mantén expectativas acordes.

¿Cómo configurar un canal de Line?

Paso 1. Ve a Configuración → Bandejas de entrada → “Agregar bandeja de entrada”. Paso 2. Haz clic en el ícono de "Line". Paso 3. Ve a la Consola de Desarrollador de Line y crea una cuenta de Line. Paso 4. Crea un "Proveedor" en la consola de desarrollador. Crea un nuevo canal "Messaging API" (Bot) bajo el proveedor. Paso 5. Completa los siguientes campos desde la consola de desarrollador de Line (Canal de Messaging API) y haz clic en "Crear Canal de LINE". 1. Nombre del canal 2. ID del Canal de LINE 3. Secreto del Canal de LINE 4. Token del Canal de LINE Paso 6. "Agrega agentes" a tu bandeja de entrada de Line. La configuración de la bandeja de entrada está completa. Paso 7. Ve al canal "Messaging API" en la consola de desarrollador y configura el webhook. 1. Verifica la URL del webhook de Chatwoot 2. Habilita "Usar webhook" Paso 8. Prueba tu nueva bandeja de entrada de Line. Envía un mensaje al bot de Line. Revisa la bandeja de entrada de Line en Chatwoot para ver el nuevo mensaje.

¿Cómo crear una bandeja de entrada de canal API?

Para crear y configurar un buzón de canal API en instalaciones de Chatwoot, sigue el paso descrito a continuación. Configura el canal API Paso 1. Ve a Configuración → Buzones → “Agregar Buzón”. Paso 2. Haz clic en el icono "API". Paso 3. Proporciona un nombre para el canal y una URL de callback. Aquí tienes un ejemplo: Paso 4. "Agregar agentes" a tu buzón API. La configuración del buzón está completa. Envía mensajes al canal API Para enviar mensajes al canal API, asegúrate de comprender los siguientes modelos y la nomenclatura utilizada en Chatwoot. 1. Canal: Un canal define el tipo de fuente de las conversaciones. Ej., Facebook, Twitter, API, etc. 2. Buzón: Puedes crear múltiples fuentes de conversaciones del mismo tipo de canal. Ej., Puedes tener más de una página de Facebook conectada a una cuenta de Chatwoot. Cada página se llama buzón en Chatwoot. 3. Conversación: Una conversación es una colección de mensajes. 4. Contacto: Cada conversación tiene una persona real asociada a ella, llamada contacto. 5. Buzones de contacto: Esta es la sesión de cada contacto en un buzón. Un contacto puede tener múltiples sesiones y múltiples conversaciones en el mismo buzón. ¿Cómo enviar un mensaje en un canal API? Para enviar un mensaje en un canal API, crea un contacto, inicia una conversación y finalmente envía el mensaje. Las API requieren el api_access_token en el encabezado de la solicitud. Puedes obtener este token visitando tu configuración de Perfil → Token de Acceso. 1. Crear un contacto Ref: Documentación de la API Pasa el ID del buzón del canal API junto con los demás parámetros especificados. Esto creará una sesión para ti automáticamente. Una respuesta de ejemplo se vería como la siguiente. { "email": "string", "name": "string", "phone_number": "string", "thumbnail": "string", "additional_attributes": {}, "contact_inboxes": [ { "source_id": "string", "inbox": { "id": 0, "name": "string", "website_url": "string", "channel_type": "string", "avatar_url": "string", "widget_color": "string", "website_token": "string", "enable_auto_assignment": true, "web_widget_script": "string", "welcome_title": "string", "welcome_tagline": "string", "greeting_enabled": true, "greeting_message": "string" } } ], "id": 0, "availability_status": "string" } Como puedes ver en la carga útil, podrás ver los contact_inboxes y cada contact_inbox tendrá un source_id. Source ID puede ser visto como el identificador de sesión. Utilizarás este source_id para crear una nueva conversación como se define a continuación. 2. Crear una conversación Ref: Documentación de la API Usa el source_id recibido en la llamada API anterior. Recibirás un ID de conversación que puede ser utilizado para crear un mensaje. { "id": 0 } 3. Crear un mensaje nuevo Ref: Documentación de la API Hay 2 tipos de mensajes. 1. Entrante: Los mensajes enviados por el usuario final se clasifican como mensajes entrantes. 2. Saliente: Los mensajes enviados por el agente se clasifican como mensajes salientes. Si llamas a la API con el contenido correcto, recibirás una carga útil similar a esta: { "id": 0, "content": "This is a incoming message from API Channel", "inbox_id": 0, "conversation_id": 0, "message_type": 0, "content_type": null, "content_attributes": {}, "created_at": 0, "private": false, "sender": { "id": 0, "name": "Pranav", "type": "contact" } } Si todo es exitoso, verás la conversación en el panel como se muestra a continuación. Serás notificado cuando se cree un nuevo mensaje en la URL especificada al crear el canal API. Puedes leer sobre la carga útil del mensaje aquí. Recibir mensajes usando URL de callback Cuando se crea un mensaje nuevo en el canal API, recibirás una solicitud POST en la URL de Callback especificada al crear el canal API. La carga útil sería así. Encuentra la lista completa de eventos soportados por el webhook aquí. Tipo de evento: message_created { "id": 0, "content": "This is a incoming message from API Channel", "created_at": "2020-08-30T15:43:04.000Z", "message_type": "incoming", "content_type": null, "content_attributes": {}, "source_id": null, "sender": { "id": 0, "name": "contact-name", "avatar": "", "type": "contact" }, "inbox": { "id": 0, "name": "API Channel" }, "conversation": { "additional_attributes": null, "channel": "Channel::Api", "id": 0, "inbox_id": 0, "status": "open", "agent_last_seen_at": 0, "contact_last_seen_at": 0, "timestamp": 0 }, "account": { "id": 1, "name": "API testing" }, "event": "message_created" } Crear interfaces usando APIs cliente Las APIs cliente disponibles para el canal API te ayudarán a construir interfaces orientadas al cliente para Chatwoot. Estas APIs son útiles para casos como los listados a continuación. 1. Usar una interfaz de chat personalizada en lugar del widget de chat de Chatwoot. 2. Construir interfaces conversacionales en tus aplicaciones móviles. 3. Agregar Chatwoot a otras plataformas para las que Chatwoot no tenga un SDK oficial. Creando objetos de cliente Puedes crear y recuperar objetos de datos de clientes usando el inbox_identifier y el customer_identifier. Identificador de Buzón Puedes obtener el inbox_identifier desde tu canal API -> Configuración -> Configuración. Identificador de Cliente El customer_identifier o source_id se puede obtener al crear el cliente utilizando la API de crear. Deberás almacenar este identificador en tu lado cliente para realizar más solicitudes en nombre del cliente. Esto se puede hacer en cookies, almacenamiento local, etc. APIs Disponibles Las APIs cliente disponibles están documentadas aquí. Algunas de las cosas que puedes hacer con las APIs son: - Crear, Ver y Actualizar Contactos - Crear y Listar Conversaciones - Crear, Listar y Actualizar Mensajes Autenticación HMAC Las APIs cliente también soportan Autenticación HMAC. El token HMAC del canal puede obtenerse ejecutando lo siguiente en tu consola de rails. # reemplaza api_inbox_id con tu id de buzón Inbox.find(api_inbox_id).channel.hmac_token Conectar a los WebSockets de Chatwoot Para obtener actualizaciones en tiempo real desde el panel de agente, conéctate a los WebSockets de Chatwoot usando la siguiente URL. <your installation url>/cable Autenticando tu conexión WebSocket Después de suscribirte usando el pubsub_token del cliente, recibirás eventos dirigidos hacia tu objeto cliente. El pubsub_token se proporciona durante la llamada API de creación del cliente. Ejemplo const connection = new WebSocket('ws://localhost:3000/cable'); connection.send(JSON.stringify({ command:"subscribe", identifier: "{\\"channel\\":\\"RoomChannel\\",\\"pubsub_token\\":\\""+ customer_pubsub_token+"\\"}" })); Encuentra la lista completa de eventos soportados por WebSockets aquí. Verificación de Webhook Una vez que crees un canal API, generamos automáticamente un secreto que puedes usar para verificar la carga útil que recibe tu aplicación. Puedes leer más sobre la verificación de webhooks aquí. Implementación He aquí un ejemplo de interfaz de chat construida sobre las APIs cliente.

Cómo configurar un canal de WhatsApp con Twilio

Administra las conversaciones de tu cuenta de WhatsApp Business a través de Chatwoot. Tienes dos opciones de proveedor: 1. WhatsApp Cloud API (forma preferida) 2. Twilio Esta guía te llevará paso a paso por el proceso de configuración. Requisitos previos 1. Un número de teléfono válido 2. Una cuenta de Twilio. Si no tienes una, créala aquí: https://www.twilio.com/en-us/messaging/channels/whatsapp Usando la API de Twilio Hay dos formas de usar Twilio con Chatwoot: 1. Forma regular sin servicio de mensajería 2. Con servicio de mensajería Configuración de Twilio Sin Servicio de Mensajería Inicia sesión en tu cuenta de Twilio y haz clic en "Create New Account" Completa todos los campos requeridos y finaliza el proceso de creación de la cuenta Copia tu Account SID, Auth Token y número de teléfono. Si aún no has agregado un número de teléfono a tu cuenta de Twilio, hazlo antes de continuar. Inicia sesión en tu cuenta de Chatwoot, haz clic en Configuración > Bandeja de entrada > Agregar bandeja de entrada y selecciona Whatsapp Ingresa aquí tu Account SID, Auth Token y el número de WhatsApp Agrega agentes para gestionar tu bandeja de entrada de WhatsApp Ve a Configuración > Bandeja de entrada, selecciona tu bandeja, haz clic en Configuración y copia tu URL de webhook Vuelve a tu panel de Twilio 1. Ve a Twilio Console → Phone Numbers → Manage → Active Numbers 2. Haz clic en tu número de WhatsApp. 3. Haz clic en Configurar 4. Bajo Mensajería, verifica el campo “Webhook (When a message comes in)”. 5. Actualiza la URL del webhook. ¡Eso es todo! Ya estás listo para empezar a enviar mensajes de WhatsApp a través de Chatwoot. Configuración de Twilio con un Servicio de Mensajería Configurar Twilio con un servicio de mensajería requiere pasos adicionales comparado con la configuración regular. Navega a Mensajería > Servicios y haz clic en el botón "Create Messaging Service". Llena todos los campos requeridos en los pasos posteriores hasta llegar aquí. Copia tu ID de servicio de mensajería y haz clic en “Save”. Inicia sesión en tu cuenta de Chatwoot. Al crear una bandeja, marca la casilla "Use Twilio Message Service". Luego, copia y pega tu Account ID, Message Service ID y Token en los campos apropiados. Ve a tu panel de Twilio, navega a Messaging > Services > Select Service > Integration, y pega aquí tu URL de webhook. ¡Eso es todo, ya está listo! Ahora puedes empezar a enviar mensajes de WhatsApp a través de Chatwoot. Preguntas Frecuentes ¿Qué tipos de plantillas de WhatsApp admite Chatwoot al usar Twilio? Actualmente, Chatwoot no admite plantillas con Twilio. Estoy usando Twilio Studio. ¿Se requieren pasos adicionales para que funcione? Si usas Twilio Studio para un flujo de conversación personalizado, actualizar la URL del webhook directamente romperá tu integración existente. Sigue estos pasos en su lugar: 1. Identifica el paso en tu flujo donde quieres que ocurra el “cambio a agente”. 2. Agrega un “make http request widget” como se muestra a continuación con los valores dados. 3. Asegúrate de que tu flujo pueda manejar las respuestas de los usuarios a los agentes.

¿Cómo configurar un canal de Instagram?

Si estás utilizando una instalación autohospedada de Chatwoot, por favor configura tu aplicación de Instagram como se describe en esta guía. Para la versión en la nube de Chatwoot, por favor sigue esta guía. Requisitos previos Antes de traer tu bandeja de entrada de Instagram a Chatwoot, debes asegurarte de tener una cuenta de Instagram Business. Configura una cuenta de Instagram Business si no tienes una. Esta guía de Instagram te ayudará a hacerlo. ¿Cómo crear una bandeja de entrada de Instagram en Chatwoot? Paso 1. Ve a Configuración → Bandejas de entrada → “Agregar bandeja de entrada”. Paso 2. Haz clic en el botón "Continuar con Instagram". Paso 3. Activa "Acceder y gestionar mensajes" y haz clic en el botón permitir para continuar con la autorización Paso 5. "Agrega agentes" a tu bandeja de entrada de Instagram. Has creado exitosamente una bandeja de entrada de Instagram. Cada vez que un cliente envíe un mensaje a tu cuenta de Instagram, podrás verlo y responderlo desde Chatwoot.

Cómo configurar un canal de WhatsApp (registro integrado)

¿Qué es el registro embebido de WhatsApp? El registro embebido es una interfaz basada en navegador proporcionada por Meta que autentica a un usuario de Facebook, crea (o vincula) una Cuenta de Negocio de WhatsApp (WABA), añade un número de teléfono y devuelve credenciales de producción en un solo flujo. Chatwoot Cloud embebe esta interfaz cuando eliges WhatsApp Cloud al agregar un Buzón, por lo que no se requieren tokens manuales ni URLs de webhook. Requisitos previos de un vistazo - Inicio de sesión en Facebook (Meta) - Información de negocios - Espacio de trabajo en Chatwoot Cloud con la función de WhatsApp habilitada Flujo de incorporación dentro de Chatwoot Paso 1. Ve a Configuración → Buzones → “Agregar Buzón”. Selecciona WhatsApp. Paso 2. Haz clic en el botón "Conectar con WhatsApp Business". Paso 3. Inicia el flujo de Meta. Inicia sesión con la cuenta de Facebook que gestionará el WABA. Proporciona los datos de la empresa o selecciona una cartera existente, luego elige un WABA existente o crea uno nuevo. Paso 4. "Agrega agentes" a tu buzón de Instagram. Consejo: Usa una pestaña de navegador dedicada y desactiva los bloqueadores de anuncios; las ventanas de OAuth de Meta dependen de cookies de terceros Puntos de cumplimiento 1. Verificación del negocio: Sube los documentos legales si Meta lo solicita durante o después del registro 2. Revisión del nombre visible: Asegúrate de que el nombre visible de WhatsApp cumpla con las directrices de marca para evitar rechazos

¿Cómo configurar un canal de WhatsApp (flujo manual)?

Puedes gestionar las conversaciones de tu cuenta de WhatsApp Business desde Chatwoot. Para configurarlo, tienes dos opciones para elegir tu proveedor: 1. WhatsApp Cloud API 2. Twilio Explicaremos todos los procedimientos en esta guía. Requisitos previos 1. Necesitas una Cuenta de Desarrollador de Meta para configurar la API de WhatsApp. Si aún no tienes una cuenta de desarrollador haz clic aquí para crear una antes de continuar. 2. Un número de teléfono válido Usando Whatsapp Cloud API WhatsApp Cloud API está disponible para todas las empresas y desarrolladores individuales. Dado que está alojada en la infraestructura en la nube de Meta, ya no es necesario usar proveedores de terceros como Twilio, Zendesk, 360Dialog o MessageBird (Business Solution Providers) para alojar tu API de WhatsApp Business. Configura tu perfil de empresa Crea un perfil profesional de WhatsApp Business con el nombre de tu empresa, una descripción y tu información de contacto. Un perfil bien elaborado ayuda a los clientes a reconocer y confiar en tu marca cuando interactúan contigo. Inicia sesión en https://business.facebook.com y haz clic en el botón crear portafolio en el menú desplegable bajo Inicio. Completa todos los campos requeridos para configurar tu portafolio de empresa. Una vez que hayas creado tu portafolio de empresa, es momento de crear tu aplicación de Facebook. Configura tu aplicación de Facebook Inicia sesión en https://developers.facebook.com/ y haz clic en el botón Crear Aplicación. Completa los campos requeridos Haz clic en "Otro" de las opciones Elige "Empresa" como tipo de tu aplicación Ingresa tu correo electrónico de contacto y selecciona tu portafolio de empresa del menú desplegable. Agrega Whatsapp a tu aplicación Después de crear tu aplicación, serás dirigido al panel de control de la app. Desde allí, haz clic en "Agregar Producto" y selecciona WhatsApp de la lista de productos disponibles. Haz clic en el botón "Configurar" para WhatsApp Nota: Antes de continuar, verifica tu empresa con Meta. Tendrás que presentar documentación para la verificación, lo cual es necesario para tener acceso completo a la API. Configura un Token de Acceso Permanente para WhatsApp Cloud API Necesitarás crear un Usuario del Sistema y generar un token permanente para mantener el acceso seguro y sin interrupciones. Inicia sesión en tu cuenta de desarrollador de Facebook, selecciona tu aplicación de WhatsApp y navega a la página de configuración de empresa. Haz clic en "Usuarios del sistema" y agrega un nuevo usuario del sistema con el rol Administrador Haz clic en el botón "Agregar activos", selecciona el nombre de tu aplicación, elige la opción "Control total" y haz clic en "Asignar activos". Vuelve a la página de usuarios del sistema, selecciona tu nuevo usuario del sistema de la lista y haz clic en el botón "Generar nuevo token". Selecciona tu aplicación del menú desplegable Selecciona estos tres niveles de permisos para tu token: - whatsapp_business_manage_events - whatsapp_business_management - whatsapp_business_messaging Copia y guarda tu token Configura WhatsApp Cloud API Para crear una nueva cuenta de empresa de Meta, selecciona "crear una cuenta de empresa" del menú desplegable. Si ya tienes una cuenta de empresa, puedes seleccionarla de las opciones ya existentes. He seleccionado "crear una cuenta de empresa". Haz clic en el botón continuar. Pega tu token permanente aquí Agrega tu número de teléfono listo para producción Nota: Meta requiere un número de teléfono verificado para la configuración de la API de WhatsApp. Puedes verificar tu número usando una OTP (contraseña de un solo uso). Una vez que hayas agregado y verificado tu número de teléfono, el siguiente paso es configurar un webhook para recibir mensajes entrantes. Conectando tu cuenta de Chatwoot Conectemos tu cuenta de Chatwoot con tu WhatsApp Cloud API Copia tu ID de número de teléfono de WhatsApp y el ID de la cuenta de empresa desde esta sección Inicia sesión en tu cuenta de Chatwoot, ve a Configuración > Bandeja de entrada, y selecciona el canal WhatsApp Ingresa tu número de teléfono, el ID del número de teléfono y el ID de empresa de tu configuración de API de WhatsApp Agrega miembros del equipo a tu bandeja de entrada de WhatsApp Copia la URL del webhook y el token de verificación del webhook que se muestra aquí Configura tu Webhook Necesitamos configurar el webhook de WhatsApp para recibir los mensajes de clientes enviados a tu número de empresa. Tu URL de devolución de llamada debe tener el formato https://app.chatwoot.com/webhooks/whatsapp/{phone_number}. Inicia sesión en tu cuenta de desarrollador de Facebook y navega a WhatsApp > Configuración Pega aquí la URL de tu webhook de Chatwoot y el token de verificación, luego haz clic en "Verificar y guardar" Configura los permisos del webhook suscribiéndote a los mensajes ¡Eso es todo! Ya puedes comenzar a enviar mensajes de WhatsApp a través de Chatwoot. Preguntas frecuentes (FAQ’s) ¿Cómo configurar varios números bajo una sola aplicación de Facebook? La aplicación de Facebook permite configurar solo un único endpoint de Webhook. Así que crea Bandejas de entrada en Chatwoot para todos los números que sean necesarios. Deberás configurar la URL de Webhook proporcionada solo para una de estas bandejas en la app de Facebook para que todas las demás funcionen. ¿Qué tipo de plantillas de WhatsApp son compatibles con Chatwoot? Por favor consulta la documentación para más detalles sobre las plantillas. ¿Qué tipos de medios son compatibles?

¿Cómo crear un canal de TikTok?

Si estás utilizando una instalación autohospedada de Chatwoot, por favor configura tu aplicación de TikTok como se describe en esta guía. Para la versión en la nube de Chatwoot, sigue esta guía. Requisitos previos Antes de configurar el canal de TikTok, asegúrate de lo siguiente: 1. Tienes una Cuenta de Negocios de TikTok registrada en una región elegible. 2. Tu Cuenta de Negocios de TikTok está configurada para aceptar mensajes directos de todos. De lo contrario, deberás aceptar manualmente los mensajes en la aplicación de TikTok. Aprende cómo actualizar tu configuración de mensajes Configuración del canal de TikTok Paso 1: Navega a Bandejas de entrada Ve a Configuración > Bandejas de entrada y haz clic en Agregar Bandeja de Entrada. Selecciona TikTok de la lista de canales disponibles. Paso 2: Conecta tu cuenta de TikTok Haz clic en Continuar con TikTok para iniciar el proceso de autenticación. Paso 4: Autoriza Chatwoot Serás redirigido a TikTok. Revisa los permisos solicitados y haz clic en Continuar para autorizar a Chatwoot a acceder a tu Cuenta de Negocios de TikTok. Paso 5: Agrega agentes Después de la autorización, serás redirigido de vuelta a Chatwoot. Agrega agentes a la bandeja de TikTok para que puedan ver y responder los mensajes. Tu canal de TikTok ya está conectado. Los mensajes directos de TikTok entrantes aparecerán en tu panel de Chatwoot. Limitaciones de mensajería - Los clientes deben iniciar la conversación, las empresas no pueden enviar mensajes primero. - Los agentes pueden enviar hasta 10 mensajes antes de que el cliente responda. Una vez que el cliente responde, la mensajería es ilimitada. - La ventana de respuesta es de 48 horas desde el último mensaje del cliente. - Actualmente, solo se admiten mensajes de texto, imagen y compartir publicación debido a limitaciones en la API de TikTok Business Messaging. - Los mensajes enviados directamente desde la app de TikTok se sincronizarán en Chatwoot. - Los mensajes recibidos en formatos no compatibles (por ejemplo, audio, stickers) aparecerán como "Este mensaje no es compatible. Puedes ver este mensaje en la aplicación TikTok." Preguntas frecuentes ¿Por qué no puedo enviar mensajes multimedia a algunos usuarios de TikTok? Esto ocurre debido a restricciones de TikTok. Algunas regiones no permiten enviar ni recibir imágenes y, en otros casos, la cuenta del usuario puede estar marcada por TikTok. ¿Qué países admiten la mensajería empresarial de TikTok? La API de TikTok Business Messaging actualmente no está disponible en el EEE, Suiza o el Reino Unido. Las funciones de mensajería pueden estar limitadas o no estar disponibles para usuarios en estas regiones. Para conocer las regiones admitidas y las restricciones más recientes, consulta la documentación oficial de TikTok. Disponibilidad TikTok está disponible tanto en los planes en la nube como autohospedados.