Voalle icon

Voalle

Interact with Voalle API

Actions64

CRM Voalle → Criar Lead

AI-generated

Overview

This node interacts with the Voalle API to create a new lead in the CRM system. It is designed to facilitate the integration of lead data from external sources into the Voalle ERP system, automating the process of lead creation. Common scenarios include syncing leads from marketing platforms, capturing lead information from web forms, or integrating with other business systems to maintain a centralized CRM database.

Use Case Examples

  1. Creating a lead with mandatory fields such as origin code, integration code, integrator alias, and lead name.
  2. Optionally providing detailed personal data like birth date, civil status, gender, and additional names.
  3. Including contact information such as phone numbers, email, WhatsApp, and Telegram status.
  4. Specifying address details including postal code, street, city, state, and country for accurate lead location data.

Properties

Name Meaning
Código Da Origem Mandatory origin code of the contact registered in the ERP, used to identify the source of the lead.
Código Da Integração Mandatory reference code of the lead in the integrating company, used for unique identification.
Alias do Integrador Mandatory alias of the integrator registered in the ERP, identifying the system or user integrating the lead.
Nome Name of the lead, either the person's name for individuals or the company name for legal entities.
CPF/CNPJ Tax identification number of the lead, either CPF for individuals or CNPJ for companies.
Dados Pessoais (Opcional) Optional personal data including birth date, civil status, gender, secondary name, mother's name, identity document, and lead type (individual or company).
Contato (Opcional) Optional contact information including cell phone, email, phone, Telegram and WhatsApp status, and website.
Endereço (Opcional) Optional address details including postal code, street, street type, number, neighborhood, complement, reference, IBGE city code, city, state, and country.
Dados De Integração (Opcional) Optional integration data including team and seller codes for assigning responsibility within the ERP.

Output

JSON

  • json - The JSON response from the Voalle API containing the result of the lead creation request.

Dependencies

  • Voalle API authentication credentials

Troubleshooting

  • Ensure all mandatory fields (Código Da Origem, Código Da Integração, Alias do Integrador, Nome) are provided to avoid validation errors.
  • Verify the format of CPF/CNPJ and contact details to match expected patterns.
  • Check API credentials and base URL configuration to prevent authentication or connection errors.
  • Handle API error responses gracefully by inspecting the returned JSON for error messages and codes.

Discussion