Actions30
Overview
This node integrates with the Perfex CRM system via the WON API, allowing users to perform various operations on different resources such as clients, contacts, leads, projects, tasks, and invoices. Specifically for the Tarefa (Task) resource with the Deletar (Delete) operation, the node deletes a task identified by its ID from the Perfex CRM.
Common scenarios where this node is beneficial include automating task management workflows, cleaning up completed or obsolete tasks, and integrating task deletion into broader business process automations.
Practical example:
You have an automated workflow that closes projects and wants to remove all associated tasks once the project is completed. This node can be used to delete each task by its ID automatically.
Properties
| Name | Meaning |
|---|---|
| ID da Tarefa | The unique identifier of the task to delete. This is a required string input. |
Output
The output JSON contains the response data returned by the Perfex CRM API after attempting to delete the specified task. Typically, this will confirm successful deletion or provide details about the deleted task.
If an error occurs, the output may contain an error message describing the issue.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to the Perfex CRM via the WON API.
- Requires an API token credential configured in n8n to authenticate requests.
- Uses the Axios HTTP client internally to make REST API calls.
- The base URL and API token must be correctly set in the node credentials.
Troubleshooting
Common Issues
- Invalid Task ID: If the provided task ID does not exist, the API returns a 404 error.
- Authentication Errors: Missing or invalid API token will cause authentication failures.
- Connection Problems: Network issues or incorrect base URL configuration can lead to connection errors.
- API Rate Limits or Server Errors: May result in unexpected errors or timeouts.
Error Messages and Resolutions
| Error Message | Cause | Resolution |
|---|---|---|
| "Erro de autenticação: Token inválido ou não fornecido" | Invalid or missing API token | Verify and update the API token credential. |
| "Recurso não encontrado" | Task ID does not exist | Confirm the task ID is correct and exists. |
| "Erro de conexão com o servidor" | Network or server unreachable | Check network connectivity and API URL. |
| "Dados inválidos: ..." | Invalid input data format | Ensure the task ID is a valid string. |
| "Erro |
Other HTTP errors | Review the status code and message for details. |
Links and References
- Perfex CRM Official Website
- WON API Documentation (if available) (Note: link is illustrative)
- Axios HTTP Client
This summary focuses on the "Tarefa" resource with the "Deletar" operation as requested.