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
This node integrates with a WhatsApp relationship platform to send messages and perform various contact and protocol management operations. Specifically, the "Contato - Mensagem - Enviar Imagem + Legenda" operation allows sending an image with a caption (legend) to a specified WhatsApp contact.
Common scenarios for this node include:
- Sending personalized marketing or notification images with captions to customers.
- Sharing product images or promotional content directly via WhatsApp.
- Automating customer support by sending images with explanatory text.
Example use case: Automatically send a product image with a description to a customer after they place an order, enhancing engagement through WhatsApp.
Properties
| Name | Meaning |
|---|---|
| Número De Contato | Phone number of the contact including country code (e.g., 5527998282828). |
| Nome Do Contato | Contact's name used to personalize the message. |
| Texto Da Mensagem | Text message that will be sent along with the image as a caption. |
| URL Da Imagem | URL of the image to be sent (maximum size: 1MB). |
Output
The node outputs JSON data representing the result of the send image + caption operation. This typically includes confirmation details such as message ID, status, or any error information returned by the WhatsApp platform API.
If binary data is involved (not indicated here), it would represent media content; however, in this operation, only the image URL is provided as input, so output is JSON metadata about the sent message.
Dependencies
- Requires connection to the WhatsApp relationship platform via an API key credential configured in n8n.
- The node depends on external HTTP access to fetch/send the image from the provided URL.
- Proper API credentials must be set up in n8n to authenticate requests to the WhatsApp platform.
Troubleshooting
- Image Size Limit: The image URL must point to an image no larger than 1MB. Larger images may cause errors or failed sends.
- Invalid Phone Number Format: The phone number must include the country code without spaces or special characters. Incorrect formatting can lead to delivery failure.
- API Authentication Errors: Missing or invalid API credentials will prevent the node from sending messages. Ensure the API key is correctly configured.
- Network Issues: If the image URL is inaccessible or the WhatsApp platform is unreachable, the message will not be sent.
- Error Messages: Common errors might include "Unauthorized" (check credentials), "Invalid number" (check phone format), or "Payload too large" (reduce image size).
Links and References
- WhatsApp Business API documentation (general reference): https://developers.facebook.com/docs/whatsapp
- n8n documentation on credentials setup: https://docs.n8n.io/credentials/overview/
- Best practices for WhatsApp media messages: https://developers.facebook.com/docs/whatsapp/api/media-messages