Actions58
- Acesso - Credenciais
- Canais - Listar
- Contato - Adicionar Etiqueta
- Contato - Adicionar Informações
- Contato - Consultar
- Contato - Editar Perfil
- Contato - Encaminhar
- Contato - Importar
- Contato - Listar Protocolos
- Contato - Listar Todos
- Contato - Mensagem - Enviar
- Contato - Mensagem - Enviar Imagem + Legenda
- Contato - Pesquisar
- Contato - Remover Etiqueta
- Contato - Status De WhatsApp
- Etiquetas - Listar Todos
- Extra - Cep - Pesquisar
- Extra - Cnpj - Pesquisar
- Extra - Coordenadas - Pesquisar
- Extra - Cpf - Pesquisar
- Extra - CSV - Formatar
- Extra - Nome - Pesquisar
- Extra - Titularidade - Pesquisar
- Extra - Transcrição - Documentos
- Extra - Transcrição - Imagem EN
- Extra - Transcrição - Imagem PT
- Grupos - Adicionar Contato
- Grupos - Listar Contatos
- Grupos - Listar Todos
- Grupos - Remover Contato
- Grupos - WhatsApp - Histórico
- Grupos - WhatsApp - Listar
- Grupos - WhatsApp - Membros
- Marketing - Campanha - Listar
- Marketing - Campanha - Resumo
- Marketing - Mensagem - Enviar
- Marketing - Mensagem - Listar
- Marketing - Mensagem - Status
- Produto - Categoria - Listar
- Produto - Listar
- Protocolo - Consultar
- Protocolo - Encaminhar - Recado
- Protocolo - Finalizar
- Protocolo - Listar - Todos
- Protocolo - Mensagem - Enviar
- Protocolo - Mensagem - Listar
- Protocolo - Observações - Adicionar
- Protocolo - Observações - Listar
- Protocolo - Pesquisar
- Recados - Listar - Todos
- Recados - Pesquisar
- Setor - Listar - Todos
- Templates - Listar - Todos
- Usuário - Agenda - Listar
- Usuário - Carteira - Adicionar
- Usuário - Carteira - Listar
- Usuário - Carteira - Remover
- Usuário - Listar - Todos
Overview
The node interacts with a WhatsApp-based customer relationship platform, specifically providing an operation to search for protocols (support tickets or cases) using various filters. This "Protocolo - Pesquisar" operation allows users to query protocol records based on criteria such as contact information, status, date ranges, assigned operators, departments, and tags.
This node is beneficial in scenarios where automated workflows need to retrieve specific protocol data from the platform for reporting, monitoring, or further processing. For example, a support team could use it to fetch all open protocols assigned to a particular operator or to find protocols linked to a certain contact within a date range.
Properties
| Name | Meaning |
|---|---|
| Paginação (page) | Page number for paginated protocol search results. |
| Filtros (filter) | Filter type to apply when searching protocols. Options: - Protocolos De Auto Atendimento - Protocolos Com Filtros De Contatos - Protocolos Com Status (Abertos Ou Fechados) - Protocolos De Atendimentos Abandonados - Protocolos Durante Um Período - Protocolos Vinculados A Um Atendente - Protocolos Vinculados A Um Departamento - Protocolos Vinculados A Uma Etiqueta - Protocolos Não Atendidos |
| Nome Ou Número Do Contato (search) | Contact name or number used to search protocols. Only shown when filter "Protocolos Com Filtros De Contatos" is selected. |
| Protocolos Abertos (open) | Boolean indicating whether to filter protocols by open status. Only shown when filter "Protocolos Com Status (Abertos Ou Fechados)" is selected. |
| Relacionamentos Humanizado (att) | Boolean indicating if the protocol is operational or self-service. Only shown when filter "Protocolos Com Status (Abertos Ou Fechados)" is selected. |
| Data Inicial (start_at) | Start date (YYYY-MM-DD) for filtering protocols during a period. Only shown when filter "Protocolos Durante Um Período" is selected. |
| Data Final (finish_at) | End date (YYYY-MM-DD) for filtering protocols during a period. Only shown when filter "Protocolos Durante Um Período" is selected. |
| Identificador Do Operador (operator) | Operator identifier to filter protocols assigned to a specific operator. Only shown when filter "Protocolos Vinculados A Um Atendente" is selected. |
| Identificador Do Setor (department) | Department identifier to filter protocols linked to a specific department. Only shown when filter "Protocolos Vinculados A Um Departamento" is selected. |
| Identificador Da Etiqueta (tag) | Tag identifier to filter protocols associated with a specific tag. Only shown when filter "Protocolos Vinculados A Uma Etiqueta" is selected. |
Output
The node outputs JSON data representing the list of protocols matching the specified search criteria. Each item in the output typically contains details about individual protocols such as protocol ID, status, related contact info, timestamps, assigned operator or department, and any relevant tags or metadata.
No binary data output is indicated for this operation.
Dependencies
- Requires connection to the external WhatsApp-based customer relationship platform via an API.
- The node needs an API authentication token or key credential configured in n8n to access the platform's endpoints.
- Proper permissions on the platform are necessary to perform protocol searches.
Troubleshooting
Common Issues:
- Invalid or missing API credentials will cause authentication failures.
- Using incompatible filter options or missing required parameters for a chosen filter may result in empty results or errors.
- Date format errors if
start_atorfinish_atare not provided in the expected YYYY-MM-DD format. - Pagination parameters out of range might lead to no data returned.
Error Messages:
- Authentication errors: Check that the API key or token is correctly set up and has sufficient permissions.
- Validation errors: Ensure all required properties for the selected filter are provided and correctly formatted.
- Network or timeout errors: Verify connectivity to the external platform and retry.
Links and References
- No direct links available from the source code.
- Refer to the external WhatsApp platform's official API documentation for detailed protocol search capabilities and parameter definitions.