Evolution API Direct icon

Evolution API Direct

Interact with Evolution API using direct URL and API Key

Actions64

Overview

This node, named "Evolution API Direct," allows users to send a list message through the Evolution API by specifying direct parameters such as server URL, API key, instance name, recipient number, and detailed list content. It is particularly useful for automating WhatsApp or similar messaging platform interactions where sending structured list messages (with sections and selectable rows) is required.

Common scenarios include:

  • Sending interactive lists of options to customers in support or sales workflows.
  • Automating menu selections or surveys via chatbots.
  • Broadcasting structured information with call-to-action buttons.

For example, a business could use this node to send a product catalog as a list message, allowing recipients to select items directly from the chat interface.

Properties

Name Meaning
Server URL The full URL of your Evolution API endpoint (e.g., https://api.exemplo.com).
API Key The API key credential for authenticating requests to the Evolution API instance.
Nome Da Instância The name of the Evolution API instance that will send the list message.
Número Do Destinatário The recipient's phone number in international format who will receive the list message.
Título Da Lista The main title of the list message displayed to the recipient.
Descrição A description text providing additional context about the list.
Texto Do Botão The label text shown on the button that opens the list options (default: "Ver Opções").
Texto Do Rodapé Footer text displayed at the bottom of the list message.
Seções One or more sections within the list, each containing multiple rows. Each section has:
- Título Da Seção: Section title.
- Linhas: Rows with title, optional description, and unique row ID.
Opções (Delay) Delay in milliseconds before sending the message (default 1200 ms).
Opções (Responder Mensagem) Optionally specify a message ID to reply to (quote) when sending the list message.
Opções (Menções) Mention settings:
- Mencionar Todos: Whether to mention all participants in a group.
- Números Para Mencionar: Comma-separated phone numbers to mention individually if not mentioning all.

Output

The node outputs a JSON array where each item corresponds to the response from the Evolution API after attempting to send the list message. The structure typically includes confirmation details such as message IDs, status, or error information returned by the API.

If binary data were involved (not indicated here), it would represent media attachments or similar payloads, but this node focuses on JSON responses related to message sending.

Dependencies

  • Requires access to the Evolution API endpoint specified by the user.
  • Needs a valid API key credential for authentication.
  • The node expects the Evolution API to support sending list messages with the provided structure.
  • No other external dependencies are indicated.

Troubleshooting

  • Common issues:

    • Incorrect or missing Server URL or API Key will cause authentication failures.
    • Invalid recipient number format may result in message delivery errors.
    • Missing required fields like instance name, title, description, or sections will prevent message sending.
    • Delay values too low might cause rate limiting or API throttling.

  • Error messages:

    • "Operação não suportada." indicates an unsupported operation-resource combination; ensure you selected "Enviar Lista" under "Mensagem" resource.
    • API errors returned from the Evolution API will be passed through; check the API documentation for specific error codes.

  • Resolutions:

    • Verify all required properties are correctly filled.
    • Confirm API key validity and permissions.
    • Format phone numbers according to international standards.
    • Adjust delay to avoid hitting API rate limits.

Links and References

Note: This summary is based solely on static analysis of the provided source code and property definitions without runtime execution.

Discussion