Evolution API icon

Evolution API

Interact with Evolution API

Actions64

Overview

The "Enviar Status" operation of the "Mensagem" (Message) resource in this custom n8n node allows you to post a status update (text, image, video, or audio) via the Evolution API. This is typically used for sending WhatsApp-like status updates to selected contacts or all contacts associated with a specific instance.

Common scenarios:

  • Broadcasting announcements or updates to all users.
  • Sharing media-rich statuses (images, videos, audios) with captions.
  • Sending targeted status messages to a specific list of contacts.

Practical examples:

  • A business can use this node to send promotional images as status updates to all customers.
  • An organization might share important text-based notifications only with select team members.

Properties

Display Name Type Description
Nome Da Instância String The name of the instance that will send the status. Required.
Tipo Do Status Options Choose the type of status to post: Text, Image, Video, or Audio.
Conteudo Ou URL String The content or URL of the image/video/audio to be posted. Required.
Texto Para Status De Imagem/Video String Caption text for image or video status.
Cor Do Background Color Background color for the status.
Font Do Texto Options Select the font style for your text status.
Enviar Para Todos Boolean Whether to send the status to all contacts.
Lista De Contatos String List of contacts (comma-separated) who will receive the status. Required if not sending to all.

Output

The node outputs a JSON array containing the result(s) of the status posting operation. The structure typically includes:

[
  {
    "success": true,
    "message": "Status sent successfully",
    "details": { /* Additional information about the operation */ }
  }
]
  • If the operation fails, the output may include an error message and details about the failure.
  • No binary data is produced by this operation.

Dependencies

  • External Service: Requires access to the Evolution API.
  • API Key/Credentials: You must configure valid Evolution API credentials in n8n under the credential type evolutionApi.
  • n8n Configuration: Ensure the node is properly authenticated and has network access to https://doc.evolution-api.com/api-reference.

Troubleshooting

Common issues:

  • Missing or invalid credentials: Ensure the Evolution API credentials are correctly set up in n8n.
  • Unsupported operation/resource: If you see an error like "Operação não suportada," check that you have selected a valid combination of Resource and Operation.
  • Required fields missing: Make sure all required properties (such as "Nome Da Instância" and "Conteudo Ou URL") are filled in.
  • Contact list errors: If "Enviar Para Todos" is false, ensure "Lista De Contatos" is provided and formatted correctly (comma-separated).

Error messages:

  • "Operação não suportada."
    Resolution: Verify that the selected operation is available for the chosen resource.
  • Credential or connection errors from the Evolution API
    Resolution: Check your API key and network connectivity.

Links and References

Discussion