WiizoChat
Actions12
Overview
The node "WiizoChat" provides comprehensive integration with the Wiizo API, enabling automation of WhatsApp messaging and related CRM functionalities such as managing contacts, tickets, companies, tags, and message scheduling.
Specifically, the "⏰ Criar Agendamento" (Create Schedule) operation allows users to schedule WhatsApp messages to be sent at a specified date and time. It supports both text and media messages, optional recurrence for repeated sending, and can optionally open a support ticket when the message is sent.
This node is beneficial in scenarios like:
- Automating customer follow-ups by scheduling reminder messages.
- Sending promotional campaigns or notifications at planned times.
- Managing customer support workflows by opening tickets automatically upon scheduled message delivery.
Example use case: A business wants to send a scheduled WhatsApp message to a client reminding them of an appointment, optionally opening a support ticket if needed, and possibly repeating this reminder weekly.
Properties
| Name | Meaning |
|---|---|
| Número do WhatsApp | The recipient's WhatsApp number (e.g., 555195813085). |
| Mensagem | The text content of the message to be sent. |
| Nome do Contato | Optional name of the contact associated with 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 | Status of the ticket created (if any). Options: 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. |
| Data e Hora de Envio | Date and time when the message should be sent (required). |
| Recorrência | Boolean indicating if the message should be recurring (sent repeatedly). |
| Abrir Ticket | Boolean indicating whether to open a support ticket when the message is sent. |
| Conexão | Connection ID used for the message sending context. |
Output
The output JSON contains the response from the Wiizo API after creating the scheduled message. This typically includes details about the scheduled message record such as its ID, status, and metadata confirming the scheduling.
No binary data output is involved in this operation.
Dependencies
- Requires an active Wiizo API credential configured in n8n with appropriate permissions.
- The node uses HTTP requests authenticated via this credential to communicate with the Wiizo API endpoints.
- The base URL for the API is obtained from the credential configuration.
Troubleshooting
- Missing Credentials: If credentials are not found, the node throws an error "Credenciais não encontradas". Ensure that the Wiizo API credential is properly set up in n8n.
- Invalid Phone Number: The WhatsApp number must be numeric and correctly formatted; otherwise, the API may reject the request.
- Date/Time Format: The "Data e Hora de Envio" must be a valid datetime string; invalid formats will cause errors.
- API Errors: Any API-level errors (e.g., unauthorized, bad request) will be returned in the node output. Check the API response for details.
- Optional Fields: Omitting optional fields like userId, queueId, or tagId is allowed, but ensure required fields are provided.
- Recurrence Logic: If recurrence is enabled, verify that the API supports the intended recurrence pattern.
Links and References
- Wiizo API Documentation (Assumed official docs, replace with actual if available)
- n8n Documentation on Creating Custom Nodes
- WhatsApp Business API general info: https://developers.facebook.com/docs/whatsapp
This summary focuses on the "createSchedule" operation of the WiizoChat node, describing its inputs, outputs, and usage based on static code analysis and provided property definitions.