Clientes Online - WhatsApp
Actions59
- Acesso - Credenciais
- Canais - Listar
- Contato - Adicionar Etiqueta
- Contato - Adicionar Informações
- Contato - Consultar
- Contato - Editar Perfil
- Contato - Encaminhar
- Contato - Importar
- Contato - Importar - Lote
- 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/TSV - 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
This node integrates with the "Clientes Online" WhatsApp relationship platform, specifically enabling sending messages within a support protocol context. The "Protocolo - Mensagem - Enviar" operation allows users to send various types of messages (text, media, vCard, map) directly linked to a specific customer service protocol number.
Typical use cases include:
- Sending updates or responses to customers tied to an existing support ticket or protocol.
- Sharing multimedia content such as images, videos, audio, files, or location maps related to the ongoing support interaction.
- Transmitting contact information via vCard format within the conversation thread of a protocol.
For example, a support agent can send a text message update about a service request, attach an image showing a product issue, or share a location map for a technician visit, all associated with the customer's protocol number.
Properties
| Name | Meaning |
|---|---|
| ID Do Protocolo | The unique protocol number identifying the customer service ticket to which the message is sent. (Required) |
| Tipo Da Mensagem | Type of message to send. Options: Arquivo (file), Áudio (audio), Imagem (image), Mapa (map), Texto (text), VCard (vcard), Vídeo (video). Default is Texto (text). |
| Texto Da Mensagem | Text content of the message, applicable when type is text, image, or video. |
| URL Da Mídia | URL of the media file to be sent, used for image, video, audio, or file message types. |
| Nome Do Contato (VCard) | Contact name to include in a vCard message. |
| Telefone (VCard) | Phone number to include in a vCard message. |
| Nome Do Lugar (Mapa) | Name of the place to send in a map message. |
| Latitude (Mapa) | Latitude coordinate for the map location. |
| Longitude (Mapa) | Longitude coordinate for the map location. |
Output
The node outputs JSON data representing the result of the message sending operation. This typically includes confirmation details such as message IDs, status, timestamps, or error information if the sending failed.
If the message involves media, the output confirms successful upload or linking of the media resource.
No binary data output is indicated by the source code; all outputs are structured JSON responses from the API.
Dependencies
- Requires connection to the Clientes Online WhatsApp platform via an API key credential configured in n8n.
- The node depends on the external Clientes Online API to perform message sending and protocol management.
- Proper authentication credentials must be set up in n8n for this node to function.
Troubleshooting
Common issues:
- Invalid or missing protocol number will cause the API to reject the message sending request.
- Incorrect media URLs or unsupported media types may lead to failures in sending media messages.
- Missing required fields for certain message types (e.g., vCard requires contact name and phone) will cause errors.
- Authentication failures due to invalid or expired API keys.
Error messages:
- "Protocol not found" or similar indicates the provided protocol ID does not exist or is inaccessible.
- "Invalid media URL" suggests the media link is unreachable or improperly formatted.
- "Missing required parameters" points to incomplete input properties for the selected message type.
- "Authentication failed" means the API key credential needs verification or renewal.
To resolve these, verify all required inputs, ensure media URLs are accessible, and confirm that API credentials are valid and have necessary permissions.
Links and References
- Clientes Online WhatsApp Platform Documentation (example placeholder, replace with actual URL if available)
- n8n documentation on Creating Custom Nodes
- General WhatsApp Business API guidelines for message types and formats.