Evolution API icon

Evolution API

Interact with Evolution API

Overview

This node interacts with the Evolution API to send status updates (stories) via a messaging service. It supports sending different types of statuses such as text, image, video, and audio. Users can specify the instance name sending the status, the content or URL of the media, optional captions for image/video statuses, background color, font style for text, and choose whether to send the status to all contacts or a specific list of contacts. This node is useful for automating status updates in messaging platforms, for example, broadcasting announcements, sharing media updates, or posting audio messages to selected contacts or all contacts.

Use Case Examples

  1. Sending a text status update to all contacts announcing a new product launch.
  2. Posting an image status with a caption to a specific list of contacts.
  3. Sharing a video status with a custom background color and font to selected contacts.

Properties

Name Meaning
Instance Name The name of the instance that will send the status. This is required to identify the sender.
Status Type The type of status to post, such as text, image, video, or audio.
Content Or URL The content or URL of the media (image, video, audio) or text 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 or media display, specified as a color code.
Font Of Text Font style to use for the text in the status.
Send To All Boolean flag indicating whether to send the status to all contacts.
Contact List Comma-separated list of contacts who will receive the status if not sending to all contacts.

Output

JSON

  • statusId - Identifier of the sent status message.
  • statusType - Type of the status sent (text, image, video, audio).
  • sentToAll - Boolean indicating if the status was sent to all contacts.
  • recipients - List of contacts who received the status.
  • timestamp - Timestamp when the status was sent.

Dependencies

  • Requires an API key credential for authenticating with the Evolution API service.

Troubleshooting

  • Ensure the 'Instance Name' is correctly specified and matches the registered instance in the Evolution API service.
  • If sending to specific contacts, verify the 'Contact List' is correctly formatted as a comma-separated string of valid contact identifiers.
  • Check that the 'Content Or URL' field contains valid content or accessible URLs, especially for media types (image, video, audio).
  • If the API returns authentication errors, verify that the API key credential is correctly configured and has necessary permissions.
  • Network or API endpoint issues may cause failures; ensure the base URL 'https://doc.evolution-api.com/api-reference' is reachable and correct.

Discussion