Wazend API icon

Wazend API

Interact with Wazend API
Join our community

Actions59

Overview

This node, named "Wazend API," is designed to interact with the Wazend messaging platform via its API. Specifically, for the resource Mensaje and operation Enviar Lista, it sends a structured list message to a specified recipient through a given instance of the Wazend service.

Common scenarios where this node is beneficial include:

  • Sending interactive lists in chat conversations to allow users to select options easily.
  • Automating customer support or marketing messages that require presenting multiple choices.
  • Creating menus or catalogs within messaging apps to enhance user engagement.

For example, a business could use this node to send a product catalog as a list message, where each section represents a category and rows represent individual products. The recipient can then tap on an option to respond or trigger further actions.

Properties

Name Meaning
Nombre De La Instancia The name of the Wazend instance that will send the list message. This identifies which configured account or session to use.
Número Del Destinatario The phone number or identifier of the message recipient.
Título De La Lista The main title displayed at the top of the list message.
Descripción A description text providing additional context or information about the list.
Texto Del Botón The label text shown on the button that opens the list options (default: "Ver Opciones").
Texto Del Pie De Página Footer text displayed at the bottom of the list message.
Secciones One or more sections in the list. Each section has:
- Título De La Sección: Title of the section.
- Filas: Multiple rows/options, each with:
- Título: Row title (required).
- Descripción: Optional row description.
- ID De La Fila: Unique ID for the option.
Opciones Additional message options including:
- Delay: Milliseconds delay before sending the message (default 1200 ms).
- Responder Mensaje: Optionally reply quoting a specific message by its ID.
- Menciones: Settings to mention all participants or specific numbers separated by commas.

Output

The node outputs a JSON array containing the response from the Wazend API after attempting to send the list message. The exact structure depends on the API but typically includes confirmation details such as message IDs, status, timestamps, or error information if the send failed.

If the node supports binary data output (not indicated here), it would relate to media attachments or message receipts, but for this operation, the focus is on JSON response data.

Dependencies

  • Requires an active Wazend API credential configured in n8n to authenticate requests.
  • Network access to the Wazend API endpoint (https://docs.wazend.net/wazend).
  • Properly configured instance names matching those recognized by the Wazend service.

Troubleshooting

  • Common Issues:

    • Invalid or missing instance name may cause authentication or routing failures.
    • Incorrect recipient number format can lead to message delivery errors.
    • Missing required fields like title, description, or button text will likely cause validation errors.
    • Delay values too low might cause rate limiting or unexpected behavior.
    • Quoting a non-existent message ID may result in errors or ignored replies.

  • Error Messages:

    • "Operação não suportada." indicates the selected operation-resource combination is not implemented; verify correct resource and operation selection.
    • API errors returned from Wazend (e.g., unauthorized, invalid parameters) should be checked in the node's execution logs.

  • Resolutions:

    • Double-check all required properties are filled correctly.
    • Ensure the API credentials are valid and have necessary permissions.
    • Validate phone numbers and IDs conform to expected formats.
    • Use appropriate delays to avoid hitting API rate limits.

Links and References

  • Wazend API Documentation — Official API docs for detailed message formatting and capabilities.
  • n8n Documentation on Creating Custom Nodes — For understanding how nodes interact with APIs.
  • Messaging List Message Format Guides (general concept) — Useful for designing effective list messages in chat platforms.

Discussion