Otros canales
Por Sojan
Por Sojan
Conecta y gestiona canales como correo electrónico, WhatsApp, Facebook, Instagram, Telegram y más.
¿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 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 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 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.