Actions23
- Validar WhatsApp
- Validar CPF
- Validar Data
- Transferir para Fila
- Transferir para Atendente
- Fechar Ticket
- Enviar Mensagem
- Enviar Botões
- Enviar Lista
- Enviar Mídia com Caption
- Enviar Base64
- Vincular Tag
- Criar Tag
- Listar Kanbans
- Vincular Kanban
- Vincular Carteira
- Listar Serviços
- Listar Usuários Disponíveis
- Listar Horários Disponíveis
- Listar Agendamentos
- Criar Agendamento
- Cancelar Agendamento
- Gerar Link do Calendário (.ics)
Overview
This node integrates with the Digitalsac API to perform various operations related to messaging, ticket management, scheduling, and validation services. Specifically, the "Enviar Mídia com Caption" (Send Media with Caption) operation allows users to send a media file along with a caption through a WhatsApp connection identified by a UUID.
Common scenarios for this node include:
- Sending multimedia messages with descriptive captions to customers via WhatsApp.
- Automating customer support interactions by sending images, documents, or other media files with context.
- Enhancing communication workflows in CRM or helpdesk systems by integrating media messaging capabilities.
Practical example:
- A support agent wants to send a product brochure PDF with a caption describing the contents directly to a customer's WhatsApp number using an established connection UUID.
Properties
| Name | Meaning |
|---|---|
| Parâmetro | The UUID of the WhatsApp connection used to send the media message. |
| Chave Externa | Optional unique identifier for the message, useful for tracking or referencing the message. |
| Caption | The text caption that accompanies the media file being sent. |
| Número de Telefone | The recipient's phone number in international format (DDI+DDD+Number), e.g., 5511999999999. |
Output
The node outputs a JSON object containing the response from the Digitalsac API after attempting to send the media with caption. This typically includes status information about the message delivery or any errors encountered.
If the operation fails, the output JSON will contain an error field with details about the failure.
The node does not output binary data itself; it expects binary input for the media file to be sent.
Dependencies
- Requires an active Digitalsac API credential with a base URL and authentication token.
- The node expects binary input data connected upstream containing the media file to send.
- Proper configuration of the WhatsApp connection UUID is mandatory.
- Network access to the Digitalsac API endpoint is required.
Troubleshooting
- Missing UUID ("Parâmetro"): The node throws an error if the connection UUID is empty or missing when sending media. Ensure the UUID is correctly provided.
- No Binary File Connected: If no binary file is attached to the input, the node will throw an error indicating that a binary file is required for sending media with caption.
- Invalid JSON Input: For other operations requiring JSON input, invalid JSON syntax will cause errors. Use proper JSON formatting.
- API Errors: If the Digitalsac API returns an error, it will be included in the output JSON under the
errorkey. Check the API credentials, network connectivity, and parameter correctness. - File Metadata Missing: The node uses filename and MIME type from the binary data metadata. If these are missing, defaults are applied but may cause issues depending on the API requirements.
Links and References
- Digitalsac API Documentation (Assumed official API docs, replace with actual link if available)
- n8n Documentation on Working with Binary Data
- WhatsApp Business API guidelines for media messaging (for understanding media message constraints)
This summary focuses on the "Enviar Mídia com Caption" operation within the Digitalsac node as requested.