Actions32
- Contatos Actions
- Oportunidades Actions
- Tarefas Actions
- Produtos Actions
- Funis Actions
- Campos Personalizados Actions
- Notas Actions
- Anexos Actions
- Propostas Actions
- Webhooks Actions
Overview
The node integrates with the Linqer CRM API to manage "Oportunidades" (Opportunities). Specifically, for the Criar (Create) operation on Opportunities, it allows users to create new sales opportunities within the CRM system. This is useful in scenarios where you want to automate the creation of sales leads or deals based on external triggers or workflows, such as form submissions, lead generation tools, or other business processes.
For example, when a new potential client fills out a contact form on your website, this node can automatically create an opportunity in Linqer CRM with relevant details like title, description, value, associated contact, funnel stage, expected close date, and related products.
Properties
| Name | Meaning |
|---|---|
| Título | Title of the opportunity (required) |
| Descrição | Description of the opportunity |
| Valor | Monetary value of the opportunity |
| Contact ID | ID of the related contact (required) |
| Funnel ID | ID of the sales funnel (required) |
| Stage ID | ID of the stage within the funnel |
| Data Esperada de Fechamento | Expected closing date of the opportunity |
| Channel ID | ID of the channel through which the opportunity came |
| Source ID | ID of the source of the opportunity |
| Produtos | List of products related to the opportunity. Each product includes: |
| - ID do Produto: Unique product ID | |
| - Nome do Produto: Product name | |
| - Quantidade: Quantity of the product | |
| - Preço: Unit price of the product | |
| Campos Customizados | Custom fields for the opportunity. Each custom field includes: |
| - ID do Campo: Unique custom field ID | |
| - Valor: Value for the custom field |
Output
The output JSON contains the response from the Linqer CRM API after creating the opportunity. It typically includes the newly created opportunity's data such as its unique ID, title, description, value, related contact and funnel information, products, custom fields, and timestamps.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating requests to the Linqer CRM API.
- The node uses HTTP requests to the Linqer CRM API endpoints under
/v1/opportunities/public. - Proper configuration of the API URL and authentication credentials in n8n is necessary.
Troubleshooting
Common issues:
- Missing required fields such as "Título", "Contact ID", or "Funnel ID" will cause the API request to fail.
- Invalid or expired API credentials will result in authentication errors.
- Providing invalid IDs for contacts, funnels, stages, channels, or sources may cause the API to reject the request.
- Incorrectly formatted dates for "Data Esperada de Fechamento" might cause validation errors.
Error messages:
"Operação 'create' não suportada para oportunidades": Indicates an unsupported operation was requested; ensure the operation parameter is set correctly.- Authentication errors usually indicate problems with the API key or token; verify credentials.
- Validation errors from the API will include messages about missing or invalid fields; check input property values.
Resolution tips:
- Double-check all required fields are provided and valid.
- Verify that the API credentials configured in n8n are correct and have sufficient permissions.
- Ensure IDs used for related entities exist in the Linqer CRM system.
- Use proper date-time formats supported by the API.
Links and References
- Linqer CRM API Documentation (general reference): https://docs.linqercrm.com/api (Note: link is illustrative, replace with actual if available)