Chatwoot

​

Configuración de la Integración con Chatwoot

​

1. Configuración en la Creación de la Instancia

​

Endpoint

POST {{baseUrl}}/instance/create

​

Cuerpo de la Solicitud

{
    "instanceName": "NOMBRE DE LA INSTANCIA",
    "number": "NUMERO DE WHATSAPP PARA GENERAR EL PAIRING CODE",
    "qrcode": true,
    "integration": "WHATSAPP-BAILEYS",
    "chatwootAccountId": "1",
    "chatwootToken": "TOKEN",
    "chatwootUrl": "https://chatwoot.com",
    "chatwootSignMsg": true,
    "chatwootReopenConversation": true,
    "chatwootConversationPending": false,
    "chatwootImportContacts": true,
    "chatwootNameInbox": "evolution",
    "chatwootMergeBrazilContacts": true,
    "chatwootImportMessages": true,
    "chatwootDaysLimitImportMessages": 3,
    "chatwootOrganization": "Evolution Bot",
    "chatwootLogo": "https://evolution-api.com/files/evolution-api-favicon.png"
}

​

2. Configuración para Instancias Existentes

​

Endpoint

POST {{baseUrl}}/chatwoot/set/{{instance}}

​

Cuerpo de la Solicitud

{
    "enabled": true,
    "accountId": "1",
    "token": "TOKEN",
    "url": "https://chatwoot.com",
    "signMsg": true,
    "reopenConversation": true,
    "conversationPending": false,
    "nameInbox": "evolution",
    "mergeBrazilContacts": true,
    "importContacts": true,
    "importMessages": true,
    "daysLimitImportMessages": 2,
    "signDelimiter": "\n",
    "autoCreate": true,
    "organization": "BOT",
    "logo": "link_de_su_logo"
}

​

Explicación de los Parámetros

• enabled: Activa (true) o desactiva (false) la integración de Chatwoot para la instancia.
• accountId: ID de la cuenta de Chatwoot asociada a la integración.
• token: Token de autenticación del usuario administrador de la cuenta en Chatwoot.
• url: URL base de Chatwoot. Importante: No incluir la / al final de la URL.
• signMsg: Cuando está activado (true), agrega la firma con el nombre del agente en los mensajes enviados.
• reopenConversation: Define si la integración debe siempre reabrir la misma conversación (true) o crear una nueva.
• conversationPending: Inicia las conversaciones como pendientes (true), esperando la acción de un agente.
• nameInbox: Nombre personalizado de la bandeja de entrada en Chatwoot. Si no se proporciona, la instancia usará el nombre de la instancia.
• mergeBrazilContacts: Fusiona contactos brasileños que tienen el dígito 9 adicional en sus números (true).
• importContacts: Importa los contactos de la agenda de WhatsApp a Chatwoot (true).
• importMessages: Importa los mensajes de WhatsApp a Chatwoot (true).
• daysLimitImportMessages: Define el número límite de días para la importación de mensajes antiguos de WhatsApp.
• signDelimiter: Delimitador usado para separar la firma del cuerpo del mensaje.
• autoCreate: Si está activado (true), crea automáticamente la configuración de la bandeja de entrada en Chatwoot.
• organization: Nombre del contacto del bot de comandos, usado para personalizar la interacción.
• logo: URL de la imagen a usar como foto de perfil del contacto del bot de comandos.

​

Pasos para Configurar la Integración

1. Obtenga las Credenciales y URLs:
   • Acceda al panel de Chatwoot y obtenga el accountId y el token del usuario administrador.
   • Verifique la URL base de su Chatwoot y configúrela sin la / final.
2. Cree o Configure la Instancia:
   • Use el endpoint /instance/create para configurar Chatwoot durante la creación de la instancia.
   • Use el endpoint /chatwoot/set/{{instance}} para configurar Chatwoot en una instancia ya existente.
3. Verifique la Configuración:
   • Acceda a Chatwoot para asegurarse de que la bandeja de entrada fue creada y que las configuraciones son correctas.
   • Pruebe el envío y recepción de mensajes para confirmar la integración.

​

Consideraciones Finales