Evolution API icon

Evolution API

Interact with Evolution API

Overview

The "Bloquear Contato" operation of the Chat resource in this custom n8n node allows users to block or unblock a contact via the Evolution API. This is useful for managing communication permissions within chat applications, such as preventing unwanted messages from specific contacts or restoring communication with previously blocked contacts.

Practical examples:

  • Automatically blocking spam numbers detected by another workflow.
  • Unblocking a customer after resolving a support issue.
  • Managing user access in group chats based on workflow logic.

Properties

Display Name Type Description
Nome Da Instância String Digite o nome da instância (Instance name). Required.
Contato String Número do contato (Contact number). Required.
Ação Options Ação a ser executada (Action to perform):
- Bloquear (block)
- Desbloquear (unblock). Required.

Output

The output is a JSON object (or array of objects) containing the result of the block/unblock action. The exact structure depends on the Evolution API's response, but typically includes fields indicating success, status, and possibly details about the affected contact.

[
  {
    // Example fields (actual fields depend on API response)
    "success": true,
    "message": "Contact blocked successfully",
    "contact": "5511999999999"
  }
]

Note: If the API returns binary data, it will be included as a binary property, but for this operation, only JSON output is expected.

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 additional configuration required beyond setting up the credentials.

Troubleshooting

Common Issues:

  • Invalid Credentials: If the API key or credentials are incorrect, the node will fail to authenticate.
  • Unsupported Operation: If you select an unsupported resource or operation, you may see an error like:
    Operação não suportada.
    A função "block-contact" para o recurso "chat-api" não é suportada!
    
    Resolution: Ensure you have selected the correct resource ("Chat") and operation ("Bloquear Contato").
  • Missing Required Fields: If any required property (instance name, contact, or action) is missing, the node will throw a validation error.
  • API Errors: Any errors returned by the Evolution API (such as invalid contact number or instance name) will be passed through in the output.

Links and References

Discussion