WiizoChat
Actions12
Overview
The node "WiizoChat" integrates with the Wiizo API to send WhatsApp messages and manage related entities such as contacts, tickets, companies, tags, and message schedules. Specifically, the operation 🖼️ Enviar Mensagem de Mídia (Send Media Message) allows users to send media files (images, videos, documents) via WhatsApp along with optional captions and metadata.
This node is beneficial in scenarios where automated or bulk sending of rich media content through WhatsApp is required, such as customer support, marketing campaigns, or notifications that include images or documents.
Practical example:
A company wants to send a promotional image with a caption to a customer’s WhatsApp number, optionally tagging the message with a ticket status and assigning it to a responsible user for follow-up.
Properties
| Name | Meaning |
|---|---|
| Número do WhatsApp | The recipient's WhatsApp number (e.g., 555195813085). |
| URL da Mídia | URL pointing to the media file (image, video, or document) to be sent. |
| Legenda da Mídia | Optional caption text accompanying the media. |
| Nome do Contato | Optional name of the contact receiving the message. |
| Email do Contato | Optional email address of the contact. |
| ID da Fila | Optional queue ID to categorize or route the message/ticket. |
| Status | Ticket status associated with the message; options are: "Aberto" (open), "Fechado" (closed), "Pendente" (pending). |
| ID do Usuário | Optional user ID responsible for the ticket/message. |
| ID da Tag | Optional tag ID to label or categorize the message/ticket. |
| Delay (ms) | Delay in milliseconds before sending the message. |
Output
The output JSON contains the response from the Wiizo API after attempting to send the media message. This typically includes confirmation details such as message ID, status, timestamps, or error information if the request failed.
If the node sends binary data (media), it does not output binary fields directly but relies on the media URL provided. The node handles sending media by referencing the URL rather than embedding binary data.
Dependencies
- Requires an active connection to the Wiizo API via an API key credential configured in n8n.
- The node uses HTTP requests authenticated with this credential to communicate with the Wiizo API endpoints.
- The media URL must be accessible by the Wiizo API (publicly reachable or properly authenticated).
Troubleshooting
- Missing Credentials Error: If credentials are not found, the node will throw an error. Ensure the Wiizo API credential is correctly set up in n8n.
- Invalid Media URL: If the media URL is inaccessible or invalid, the API may reject the request or fail to send the media.
- Incorrect Phone Number Format: The WhatsApp number must be in the correct international format without symbols or spaces.
- API Response Errors: The node logs API responses and status codes. Check these logs for detailed error messages from the Wiizo API.
- Delays Not Working: If delay is set but messages send immediately, verify the delay value is in milliseconds and supported by the API.
Links and References
- Wiizo API Documentation (example placeholder, replace with actual link if available)
- WhatsApp Business API Guidelines
- n8n HTTP Request Node Documentation: https://docs.n8n.io/nodes/n8n-nodes-base.httpRequest/
This summary covers the "Enviar Mensagem de Mídia" operation of the WiizoChat node based on static analysis of the source code and provided property definitions.