Método convertLeads – Comparação
Finalidade
Para converter lead em potencial, conta e contato.
URL de solicitação
Versão 1.0:
https://crm.zoho.com/crm/private/xml/Leads/convertLead?authtoken=AuthToken&scope=crmapi&leadId=entity Id&xmlData=POTENTIALXMLDATA
Versão 2.0:
URL: https://www.zohoapis.com/crm/v2/Leads/{record_id}/actions/convert
Método: POST
Corpo de solicitação: o conteúdo de um registro fornecido no formato JSON.
Header: Authorization=Zoho-oauthtoken {oauth_token}
Parâmetros de solicitação
| Versão 1.0 | Versão 2.0 |
|---|---|
| authtoken=**** | Authorization=Zoho-oauthtoken ***** – como Header. |
| scope=crmapi | N/A |
| id | O id deve ser fornecido na URL de solicitação. |
Solicitação de API de amostra:
| Solicitação na Versão 1.0 | Solicitação na Versão 2.0 |
|---|---|
| https://crm.zoho.com/crm/private/xml/Leads/convertLead?authtoken=***&id=1386586000002574001&xmlData=<Potentials> <row no="1"> <option val="createPotential">true</option> <option val="assignTo">sample@zoho.com</option> <option val="notifyLeadOwner">true</option> <option val="notifyNewEntityOwner">true</option> </row> <row no="2"> <FL val="Potential Name">Samplepotential</FL> <FL val="Closing Date">12/21/2009</FL> <FL val="Potential Stage">Closed Won</FL> <FL val="Contact Role">Purchasing</FL> <FL val="Amount">3432.23</FL> <FL val="Probability">100</FL> </row> </Potentials> | https://www.zohoapis.com/crm/v2/Leads/{record_id}/actions/convert Body: { "data": [ { "overwrite": true, "notify_lead_owner": true, "notify_new_entity_owner": true, "Accounts": "1386586000000753001", "Contacts": "1386586000000599023", "assign_to": "1386586000000105001", "Deals": { "Campaign_Source": "1386586000000803001", "Deal_Name": "Potential_Name1", "Closing_Date": "2016-02-18", "Stage": "Stage0", "Amount": 56.6 } } ] } |
Observação:
- 1386586000000753001 é o id da conta
- 1386586000000599023 é o id do contato
- 1386586000000105001 é o id do usuário
- 1386586000000803001 é o id da campanha
Respostas de amostra:
| Resposta na Versão 1.0 | Resposta na Versão 2.0 |
|---|---|
| <?xml version="1.0" encoding="UTF-8" ?> <success> <Contact param="id">1386586000002579015</Contact> <Potential param="id">1386586000002579018</Potential> </success> | { "data": [ { "Contacts":"1386586000000599023", "Deals":"1386586000002577051", "Accounts":"1386586000000753001", } ] } |