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 a WhatsApp-based customer relationship platform called SacNews, enabling users to send various types of messages directly to contacts stored in the client's database. The "Contato - Mensagem - Enviar" operation specifically allows sending notifications or messages to individual contacts via WhatsApp.
Common scenarios include:
- Sending text alerts or updates to customers.
- Sharing media such as images, videos, audio, files, or location maps.
- Delivering personalized WhatsApp Cloud API templates for marketing or transactional messages.
- Distributing vCards to share contact information easily.
Practical examples:
- A business sends appointment reminders or promotional offers as text or template messages.
- Customer support shares product images or instructional videos.
- Sales teams send location details of stores or events using map messages.
- Contact cards (vCards) are sent to facilitate easy saving of contact info.
Properties
| Name | Meaning |
|---|---|
| Atenção: SPAM Pode Gerar Penalidades Em Seu Canal | Notice warning that WhatsApp may penalize accounts identified as sending spam. |
| ID Do Contato | The unique identifier of the contact in the client’s database to whom the message will be sent. |
| Tipo De Mensagem | Type of message to send. Options include: Arquivo (file), Áudio (audio), Imagem (image), Mapa (map), Template, Texto (text), vCard, Vídeo (video), WhatsApp Cloud Template. |
| Texto Da Mensagem | Text content of the message; applicable when sending text, image, or video messages. |
| URL Da Mídia | URL pointing to the media content (image, video, audio, or file) to be sent. |
| Nome Do vCard | Name field for the vCard contact information. |
| Telefone Do vCard | Phone number included in the vCard. |
| Lugar No Mapa | Name of the place to be sent in a map message. |
| Latitude | Latitude coordinate for the map location. |
| Longitude | Longitude coordinate for the map location. |
| Template | Template identifier used for sending template or WhatsApp Cloud API template messages. |
| Definir Canal A Ser Utilizado? | Boolean flag to specify whether to select a particular channel for sending the message. |
| Canal | The specific channel to use for sending the message if channel specification is enabled. |
| Utilizar Sempre Canais Secundários | Notice advising to always use secondary channels for notification sending when channel specification is enabled. |
| ID De Identificação Do Template | JSON object containing variables to personalize the WhatsApp Cloud API template message. |
Output
The node outputs JSON data representing the response from the messaging platform after attempting to send the message. This typically includes status information about the message delivery, any error messages, and identifiers related to the sent message.
If binary data were involved (e.g., media uploads), it would be summarized here, but this node primarily handles message sending and returns JSON responses.
Dependencies
- Requires an active connection to the SacNews WhatsApp platform via an API key credential.
- The node depends on the external SacNews API to send messages and retrieve statuses.
- Proper configuration of the API authentication token within n8n credentials is necessary.
Troubleshooting
- Spam Penalties: Users should heed the spam notice property; sending unsolicited bulk messages can lead to account penalties by WhatsApp.
- Invalid Contact ID: Errors may occur if the provided contact ID does not exist in the client database.
- Incorrect Media URLs: Media messages require valid accessible URLs; broken or inaccessible links will cause failures.
- Template Variables: When sending WhatsApp Cloud API templates, missing or malformed variables JSON can cause message rejection.
- Channel Specification Issues: If specifying a channel, ensure the channel exists and is authorized for use; otherwise, message sending may fail.
- API Authentication Errors: Invalid or expired API keys will prevent successful communication with the platform.
Links and References
- WhatsApp Business API Documentation
- SacNews Platform Documentation (Replace with actual URL if available)
- n8n Credential Setup Guide