Evolution API icon

Evolution API

Interact with Evolution API

Actions64

Overview

The "Send Status" operation of the Message resource in this node allows users to post various types of status updates (text, image, video, or audio) from a specified instance. This is useful for automating status sharing on messaging platforms where statuses can be broadcasted to all contacts or selectively sent to specific contacts.

Common scenarios include:

  • Automatically posting promotional text or media statuses to customers.
  • Sharing event updates or announcements via multimedia statuses.
  • Broadcasting audio or video messages as status updates to selected contacts.

For example, a marketing automation workflow could use this node to send an image status with a caption to a targeted list of contacts, or a user could post a simple text status to all their contacts.

Properties

Name Meaning
Instance Name The name of the instance that will send the status.
Status Type The type of status to post. Options: Text Status, Image Status, Video Status, Audio Status.
Content or URL The content text or URL of the media (image/video/audio) to be posted as status.
Text for Image/Video Status Optional text caption for image or video statuses.
Background Color Background color for the status text (hex color code).
Font Font type for the status text. Options: SERIF, NORICAN REGULAR, BRYNDAN WRITE, BEBASNEUE REGULAR, OSWALD HEAVY.
Send to All Boolean flag indicating whether to send the status to all contacts.
Contact List Comma-separated list of contacts to receive the status (required if not sending to all contacts).

Output

The node outputs a JSON array containing the result of the status send operation. Each item in the output corresponds to the response from the API after attempting to send the status. The exact structure depends on the Evolution API's response but generally includes confirmation of success or failure and any relevant metadata.

If the status includes media (image, video, audio), the node handles the content via URLs; no binary data output is indicated in the source.

Dependencies

  • Requires an API key credential for authenticating with the Evolution API.
  • The node uses the base URL https://doc.evolution-api.com/api-reference for API requests.
  • Proper configuration of the API credential within n8n is necessary for successful execution.

Troubleshooting

  • Unsupported operation error: If the node throws an error about unsupported operations, verify that the Resource is set to "Message" and Operation to "Send Status".
  • Missing required parameters: Ensure all required fields such as "Instance Name", "Content or URL", and either "Send to All" or a valid "Contact List" are provided.
  • Invalid media URLs: For image, video, or audio statuses, ensure the URLs are accessible and correctly formatted.
  • API authentication errors: Confirm that the API key credential is correctly configured and has sufficient permissions.
  • Empty or malformed contact list: When not sending to all contacts, the contact list must be a comma-separated string of valid contact identifiers.

Links and References

Discussion