Actions64
- Instancia Actions
- Mensagem Actions
- Grupo Actions
- Chat Actions
- Perfil Actions
- Evento Actions
- Integração Actions
Integração → Chatwoot
AI-generatedOverview
This node integrates with the Evolution API to manage Chatwoot settings and data. It allows users to enable or disable Chatwoot integration, verify Chatwoot status, and configure various Chatwoot-related options such as importing contacts and messages, managing inboxes, and setting conversation states.
Common scenarios include:
- Automating the activation or deactivation of Chatwoot integration for a given instance.
- Importing historical contacts and messages into Chatwoot from another system.
- Managing Chatwoot inboxes and conversation statuses programmatically.
- Verifying the current Chatwoot configuration status.
Practical examples:
- Automatically enabling Chatwoot integration when a new customer support instance is created.
- Importing last 30 days of chat messages into Chatwoot for unified customer communication history.
- Setting conversations to pending state on Chatwoot upon creation to prioritize follow-up.
Properties
| Name | Meaning |
|---|---|
| Server URL | Full URL of the Evolution API server to connect to (e.g., https://api.exemplo.com). |
| API Key | API key credential for authenticating requests to the Evolution API instance or global scope. |
| Nome Da Instancia | Name of the instance that will send the message or perform the operation. |
| O Que Deseja Fazer | Choose between "Definir Chatwoot" (set Chatwoot) to activate/deactivate or configure Chatwoot, or "Verificar Chatwoot" (find Chatwoot) to check Chatwoot status. |
| Ativar Chatwoot | Boolean to enable or disable the Chatwoot integration (only for "setChatwoot" operation). |
| Link Do Chatwoot | URL link to the Chatwoot instance (required for "setChatwoot"). |
| ID Da Conta Do Chatwoot | Account ID in Chatwoot to target (required for "setChatwoot"). |
| Token De Admin Do Chatwoot | Admin token for Chatwoot authentication (required for "setChatwoot"). |
| Assinatura Do Agente Do Chatwoot | Boolean to enable or disable agent signature in Chatwoot messages. |
| Reabrir Mensagens No Chatwoot | Boolean to enable or disable reopening conversations/messages in Chatwoot. |
| Iniciar Conversas Como Pendentes No Chatwoot | Boolean to start conversations as pending in Chatwoot. |
| Importar Contatos Para O Chatwoot | Boolean to import contacts into Chatwoot. |
| Nome Da Inbox Do Chatwoot | Optional name of the Chatwoot inbox to use or create. |
| Mesclar Contatos Brasileiros No Chatwoot | Boolean to merge Brazilian contacts in Chatwoot. |
| Importar Mensagens Para O Chatwoot | Boolean to import messages into Chatwoot. |
| Importar Mensagens De Quantos Dias Para O Chatwoot | Optional number of days to limit message import to recent days only. |
| Criar Caixa De Entrada | Boolean to automatically create an inbox if it does not exist. |
| Nome Do Contato De QRCode No Chatwoot | Optional name for the QR code contact in Chatwoot. |
| Url Do Logo Para O Contato No Chatwoot | Optional URL for the logo image used for the contact in Chatwoot. |
Output
The node outputs a JSON array containing the result of the requested Chatwoot operation. The structure depends on the operation performed:
- For "setChatwoot": Confirmation of the configuration update, including status flags and any created or updated resource identifiers.
- For "findChatwoot": Details about the current Chatwoot integration status, such as whether it is enabled and relevant configuration details.
No binary data output is indicated.
Dependencies
- Requires access to the Evolution API endpoint specified by the Server URL.
- Requires a valid API key credential for authentication with the Evolution API.
- For Chatwoot operations, requires Chatwoot admin token and account information.
- Network connectivity to both Evolution API and Chatwoot services.
- Proper configuration of instance name and other parameters as per user environment.
Troubleshooting
Common issues:
- Invalid or missing API key or Chatwoot admin token causing authentication failures.
- Incorrect Server URL or Chatwoot URLs leading to connection errors.
- Missing required parameters like account ID or instance name.
- Permissions issues on Chatwoot side preventing updates or imports.
- Exceeding rate limits or API quotas on Evolution API or Chatwoot.
Error messages:
- "Operação não suportada." — This indicates the selected operation is not supported for the chosen resource; ensure correct Resource and Operation are selected.
- Authentication errors — Verify API keys and tokens are correct and have necessary permissions.
- Validation errors — Check that all required fields are filled and correctly formatted.
Resolutions:
- Double-check all input parameters for correctness.
- Ensure API credentials are valid and active.
- Confirm network connectivity and endpoint accessibility.
- Review Chatwoot account permissions and roles.
- Consult API documentation for rate limits and usage policies.