Evolution API

Overview

The "Procurar Status" operation under the "Chat" resource of this custom n8n node allows users to search for status messages associated with a specific contact in an Evolution API instance. This is particularly useful for automating workflows that need to retrieve or monitor WhatsApp status updates (or similar messaging platform statuses) for given contacts, such as tracking message delivery, reading status, or auditing communication history.

Practical examples:

• Automatically fetching the latest status messages for a customer support number.
• Monitoring the status of sent messages for compliance or reporting.
• Integrating status retrieval into CRM or helpdesk systems.

Properties

Below are the supported input properties for this operation:

Output

The output will be a JSON array containing the status messages found for the specified contact and message ID. Each item in the array represents a status message object as returned by the Evolution API.

Example output structure:

[
  {
    "messageId": "string",
    "status": "delivered",
    "timestamp": "2024-06-01T12:34:56Z",
    "contact": "5511999999999",
    // ...other fields as provided by the API
  }
]

Note: The exact fields depend on the Evolution API response.

If the node supports binary data output, it is not relevant for 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: No special environment variables required beyond standard credential setup.

Troubleshooting

Common issues:

• Missing or invalid credentials: Ensure your Evolution API credentials are correctly set up in n8n.
• Unsupported operation error: If you see an error like Operação não suportada., it means the selected operation is not implemented for the chosen resource. Double-check your resource and operation selection.
• Invalid parameters: Supplying incorrect or missing values for required fields (such as "Nome Da Instância", "Contato", or "ID Da Mensagem") will result in errors from either n8n or the Evolution API.

Error messages:

• "Opera\xE7\xE3o n\xE3o suportada."
  Resolution: Make sure you have selected a valid combination of Resource and Operation.
• API-specific errors (e.g., authentication failure, not found): Check your credentials and input values.

Links and References

• Evolution API Documentation
• n8n Documentation: Custom Nodes
• n8n Credentials Setup