Método convertLead
Índice
Finalidade
Você pode usar esse método para converter lead em potencial, conta e contato. Você também pode associar o contato ou conta existente ao lead convertido, com esse método.
Para oprocesso de conversão de lead, consulte Converter leads em outros registros de vendas, no Manual do Usuário.
URL de solicitação
Formato XML:
https://crm.zoho.com/crm/private/xml/Leads/convertLead?authtoken=Auth Token
Formato JSON:
https://crm.zoho.com/crm/private/json/Leads/convertLead?authtoken=Auth Token
Parâmetros de solicitação
| Parâmetro | Tipo de dados | Descrição |
| authtoken* | String | Sequências alfanuméricas criptografadas para autenticar suas credenciais do Zoho. |
| scope* | String | Especifique o valor como crmapi |
| leadId* | String | Especifique o ID único do lead |
| xmlData* | XML | Especifique os campos e os valores correspondentes |
| newFormat | Número inteiro | newFormat=1: para excluir campos com valores "null", ao inserir dados de sua conta CRM. newFormat=2:para incluir campos com valores "null" ao inserir dados de sua conta CRM. |
| version | Número inteiro | version = 1: (valor padrão) Irá buscar respostas com base na implementação API anterior, ou seja, antes dos aprimoramentos feitos. version = 2: irá buscar respostas com base na implementação API mais recente. |
* – Parâmetro obrigatório
Nota:
- Consulte a página de Notas de versão para saber mais sobre as melhorias feitas na implementação API.
Amostra XML para converter um lead em uma conta, contato e potencial
Nota:
- Neste XML, em
< row no="2"> é obrigatório SOMENTE se o valor de "createPotential" for definido como true. Se o valor para "createPotential" estiver definido como false, um potencial NÃO será criado na conversão do lead.
Amostra XML para associar o contato ou conta existente ao lead convertido
Nota:
- O valor assignTo pode ser ou SMOWNERID ou id do e-mail .
- Você pode associar o contato ou conta existente ao lead convertido, mesmo se o lead for ou não convertido em um potencial. Para isso, você tem de enviar ACCOUNTID e CONTACTID no xml
- Se os valores
< FL val="ACCOUNTID"> < /FL> and< FL val="OVERWRITE"> true< /FL> forem fornecidos, o nome da conta será substituído pelo nome da empresa ao associar com a conta existente. Entretanto, os dados dessa conta permanecerão os mesmos - Se o valor OVERWRITE for false, só acontecerá a associação. Se você fornecer o valor OVERWRITE sem o valor ACCOUNTID, o funcionamento do método será o mesmo
- Se
< FL val="CONTACTID"> < /FL> é fornecido, então o lead convertido será associado ao contato existente