convertLead-Methode
Inhaltsverzeichnis
Zweck
Mit dieser Methode können Sie ein Lead in ein Potenzial, Konto und einen Kontakt konvertieren. Außerdem können Sie mit dieser Methode den vorhandenen Kontakt oder das vorhandene Konto mit dem zu konvertierenden Lead verknüpfen.
Weitere Informationen zum Lead-Konvertierungsprozess finden Sie in der Bedienungsanleitung unter Leads in andere Vertriebsdatensätze konvertieren.
Anfrage-URL
XML-Format:
https://crm.zoho.com/crm/private/xml/Leads/convertLead?authtoken=Auth Token
JSON-Format:
https://crm.zoho.com/crm/private/json/Leads/convertLead?authtoken=Auth Token
Anfrageparameter
| Parameter | Datentyp | Beschreibung |
| authtoken* | Zeichenfolge | Verschlüsselte alphanumerische Zeichenfolge zur Authentifizierung Ihrer Zoho-Anmeldedaten. |
| scope* | Zeichenfolge | Geben Sie den Wert als crmapi an. |
| leadId* | Zeichenfolge | Geben Sie die eindeutige ID des Leads an. |
| xmlData* | XML | Geben Sie die Felder und die zugehörigen Werte an. |
| newFormat | Ganzzahl | newFormat=1: Um Felder mit dem Wert "Null" beim Einfügen von Daten aus Ihrem CRM-Konto auszuschließen. newFormat=2: Um Felder mit dem Wert "Null" beim Einfügen von Daten aus Ihrem CRM-Konto einzubeziehen. |
| version | Ganzzahl | Version = 1: (Standardwert) Dadurch werden Antworten auf der Grundlage der früheren API-Implementierung abgerufen, d. h. vor den vorgenommenen Erweiterungen/Verbesserungen. Version = 2: Dadurch werden Antworten basierend auf der neuesten API-Implementierung abgerufen. |
* – Obligatorischer Parameter
Hinweis:
- Auf der Seite Versionshinweise erfahren Sie mehr über die Erweiterungen/Verbesserungen, die in der API-Implementierung vorgenommen wurden.
Beispiel-XML zur Konvertierung eines Leads in ein Konto, einen Kontakt und ein Potenzial
Hinweis:
- In dieser XML ist
< row no="2"> NUR dann obligatorisch, wenn der Wert für "createPotential" auf True gesetzt ist. Wenn der Wert für "createPotential" auf "False" gesetzt ist, wird KEIN Potenzial bei der Konvertierung des Leads erstellt.
Beispiel-XML, um den vorhandenen Kontakt oder das vorhandene Konto mit dem zu konvertierenden Lead zu verknüpfen
Hinweis:
- Der Wert in assignTo kann entweder SMOWNERID oder eine E-Mail-ID sein.
- Sie können den vorhandenen Kontakt oder das bestehende Konto mit dem zu konvertierenden Lead verknüpfen. Dies trifft auch dann zu, wenn der Lead zu einem Potenzial konvertiert wird oder auch nicht. Um dies zu erreichen, müssen Sie ACCOUNTID und CONTACTID über XML übergeben.
- Wenn sowohl die Werte
< FL val="ACCOUNTID"> < /FL> und< FL val = "OVERWRITE"> true< /FL> angegeben sind, wird bei der Verknüpfung des bereits bestehenden Kontos der Kontoname durch den Unternehmensnamen ersetzt. Die Daten des Kontos bleiben hingegen identisch. - Wenn der Wert OVERWRITE falsch ist, erfolgt nur die Zuordnung. Wenn Sie jedoch den Wert OVERWRITE angeben, ohne ACCOUNTID anzugeben, bleibt die Arbeitsweise dieser Methode unverändert.
- Wenn
< FL val ="CONTACTID"> < /FL> angegeben ist, wird der zu konvertierende Lead mit dem vorhandenen Kontakt verknüpft.