Méthode convertLead
Table des matières
Objectif
Vous pouvez utiliser cette méthode pour convertir un lead en client potentiel, en compte ou en contact. Vous pouvez également associer le contact ou le compte existant au lead en phase de conversion avec cette méthode.
Pour connaître le processus de conversion des leads, consultez la rubrique Convert Leads to Other Sales Records (Convertir les leads en d'autres enregistrements de vente) du manuel de l'utilisateur.
URL de demande
Format XML :
https://crm.zoho.com/crm/private/xml/Leads/convertLead?authtoken=Auth Token
Format JSON :
https://crm.zoho.com/crm/private/json/Leads/convertLead?authtoken=Auth Token
Paramètres de demande
| Paramètre | Type de données | Description |
| authtoken* | Chaîne | Chaîne alphanumérique chiffrée utilisée pour l'authentification de vos identifiants Zoho. |
| scope* | Chaîne | Entrez la valeur crmapi |
| leadId* | Chaîne | Indiquez l'ID unique du lead |
| xmlData* | XML | Précisez les champs et les valeurs correspondantes |
| newFormat | Entier | newFormat=1 : pour exclure les champs avec des valeurs « null » lors de l'insertion de données à partir de votre compte CRM. newFormat=2 : pour inclure des champs avec des valeurs « null » lors de l'insertion de données à partir de votre compte CRM. |
| version | Entier | version = 1 : (valeur par défaut) permet de récupérer les réponses en fonction de la version d'API mise en œuvre précédemment, c.-à-d. avant les améliorations apportées. version = 2 : permet de récupérer les réponses en fonction de l'API la plus récente. |
* - Paramètre obligatoire
Remarque :
- consultez la page des Notes de mise à jour pour en savoir plus sur les améliorations apportées à la mise en œuvre de l'API.
Exemple de code XML pour convertir un lead en un compte, un contact ou un client potentiel
Remarque :
- Dans cet exemple XML,
< row no="2"> est obligatoire uniquement si "createPotential" est défini sur true. Si "createPotential" est défini sur false, AUCUN client potentiel n'est créé lors de la conversion du lead.
Exemple de code XML pour associer le contact ou le compte existant à un Lead en phase de conversion
Remarque :
- La valeur assignTo peut être SMOWNERID ou l'ID de messagerie.
- Vous pouvez associer le contact ou le compte existant au Lead en phase de conversion, que le Lead soit converti ou non en client potentiel. Pour ce faire, vous devez envoyer ACCOUNTID et CONTACTID via XML
- Si les deux valeurs
< FL val="ACCOUNTID"> < /FL> et< FL val="OVERWRITE"> true< /FL> sont définies, le nom du compte sera remplacé par le nom de l'entreprise lors de l'association avec le compte existant. Cependant, les données de ce compte resteront les mêmes. - Si la valeur de OVERWRITE est false, seule l'association s'effectuera. Toutefois, si vous indiquez la valeur OVERWRITE sans indiquer ACCOUNTID, le fonctionnement de cette méthode reste le même.
- Si
< FL val="CONTACTID"> < /FL> est défini, alors le lead en phase de conversion sera associé au contact existant.