Webhook-Beispiele
- Verrechnung von Verkaufsprozentsätzen in Zoho Creator
- Sende eine Dankes-SMS
- Erstelle ein Potenzial in Zoho CRM
Zweck: Verrechnung von Verkaufsprozentsätzen
Berechne Verkaufsprozentsätze in der Zoho Creator-Anwendung, sobald eine neue Rechnung in Zoho Books erstellt wird.
Szenario: Homes4Us ist ein Unternehmen, das Menschen bei der Suche nach Wohnungen für den Immobilienkauf unterstützt. Sie haben ein eigenes Verkaufsteam, das mehrere Kunden gleichzeitig bearbeitet. Der Verkäufer erhält 3,5 % des Immobilienwerts als Provision. Donald, der Leiter des Verkaufs bei Homes4Us, möchte, dass die Details des Kunden, des Verkäufers und der Verkaufsprovision automatisch in ein Formular eingetragen werden, sobald eine Rechnung für seine Dienstleistungen erstellt wird.
Voraussetzungen:
- Konto in der Zoho Creator-Anwendung
- Berechtigung zum Zugriff auf die Zoho-API
- Kenntnisse in Zoho Creator
Verfahren:
- Erstelle die Anwendung „Verkaufsprovision“ in Zoho Creator (siehe Zoho Creator-Tutorial zu Erstellung von Anwendungen).
- Konfiguriere den Webhook in Zoho Books.
- Stelle eine Workflow-Regel ein.
- Teste deine Webhook-Integration.
Schritt 1: Erstelle die Anwendung „Verkaufsprovision“ in Zoho Creator
In Zoho Creator erstelle eine Anwendung „Verkaufsprovision“ mit den folgenden Feldern:
- Verkäufer
- Kontaktname
- Rechnungsdatum
- Rechnungsbetrag
Hinweis: Gib “(0.035 * Invoice_Amount)” als Formel ein, um die Verkaufsprovision zu berechnen.
Schritt 2: Konfiguriere den Webhook
Während der Webhook-Konfiguration geben Sie die folgenden Angaben an:
URL zum Benachrichtigen: https://creator.zoho.com/api/xml/write
Methode: POST
Benutzerdefinierte Parameter:
- authtoken: Geben Sie den authtoken aus Ihrem Creator-Konto ein. Weitere Informationen finden Sie in der Hilfe-Dokumentation von Creator.
- zc_ownername: Geben Sie den Namen des Anwendungseigentümers aus Ihrem Creator-Konto an.
Benutzerdefinierte Parameter:
Wählen Sie die folgenden Felder aus dem Modul Rechnung und Kontakte aus, während Sie die benutzerdefinierten Parameter einrichten:
- Verkäufer
- Kontaktname
- Rechnungsdatum
- Rechnungsbetrag
XMLString
<ZohoCreator><applicationlist><application name="sales-commission"><formlist>
<form name="Commissions">
<add>
<field name="Sales_Person">
<value>${INVOICE.SALES_PERSON}</value>
</field>
<field name="Contact_Name">
<value>${INVOICE.CONTACT_NAME}</value>
</field>
<field name="Invoice_Date">
<value>${INVOICE.INVOICE_DATE}</value>
</field>
<field name="Invoice_Amount">
<value>${INVOICE.INVOICE_TOTAL}</value>
</field>
</add>
</form>
</formlist>
</application>
</applicationlist>
</ZohoCreator>
Hinweis:
- In dem oben genannten XML-String steht „name“ für das Feld in der Zoho Creator-Anwendung und der Wert für die Daten muss aus Zoho Books/Rechnung mit einem gültigen Platzhalter übertragen werden.
- Der Name der Anwendung ist der Name der Anwendung, in der das Formular in Zoho Creator enthalten ist. Rufen Sie den Anwendungsnamen aus dem Register „Anwendungs-Einstellungen“ in Zoho Creator ab.
- Der Name des Formulars ist der Name des Formulars, in dem Sie in Zoho Creator Aufzeichnungen bearbeiten. Rufen Sie den Formularnamen aus den Einstellungen des Formulars in Ihrem Zoho Creator-Konto ab.
- Stellen Sie sicher, dass das Datumformat in der Creator-Anwendung im Format yyyy-MM-dd ist. Sie können das Datumformat aus den Anwendungs-Einstellungen in Ihrem Zoho Creator-Konto ändern.
Schritt 3: Workflow-Regel einrichten
Folgen Sie den Schritten unten, um eine Workflow-Regel zu erstellen:
- Wann soll die Aktion ausgelöst werden? Wenn eine Rechnung erstellt wird.
- Sofortige Aktion: Wählen Sie den Typ als Webhook aus dem Dropdown-Menü und wählen Sie einen Webhook aus dem benachbarten Feld aus.
Klicken Sie schließlich auf Speichern, um die Workflow-Regel zu speichern.
Schritt 4: Testen Sie Ihr Workflow
Testen Sie Ihr Workflow, indem Sie eine neue Rechnung erstellen. Stellen Sie sicher, dass die Felder „Verkäufer“, „Kontaktname“, „Rechnungsdatum“ und „Rechnungsbetrag“ mit korrekten Informationen ausgefüllt sind.
Daher wird bei der Erstellung einer Rechnung ein Workflow ausgelöst, der die Verkaufskommission berechnet und diese in einem Formular in Zoho Creator speichert.
P.S.: Sie können diese Funktion verbessern, indem Sie automatisch eine Ausgabe für die Verkaufskommission in Ihrem Zoho Books-Konto erstellen. Abhängig von den Bedürfnissen der Organisation können Sie entweder eine Ausgabe für „Verkaufskommission“ jedes Mal erstellen, wenn eine Rechnung erstellt wird. Oder Sie können eine Custom Schedule für Ihr Formular einrichten, die beispielsweise den Gesamtbetrag der Verkaufskommission für einen Verkäufer berechnet und diese in Zoho Books als Ausgabe erstellt. Klicken Sie hier, um mehr über die Erstellung von Einträgen in Zoho Books mit Zoho Creator zu erfahren.
Zweck: Ein „Danke“- und BestellbestätigungssMS an Kunden senden
Sende einem Kunden ein „Danke“- und Bestellbestätigungs-SMS, sobald eine neue Rechnung in Zoho Books erstellt wird.
Szenario: Intelly Inc. ist ein Unternehmen, das maßgeschneiderte Tassen, T-Shirts, Regenschirme und verschiedene Geschenke herstellt. Kunden können die Website besuchen und dort eine Bestellung platzieren und beim Lieferung ihres Produkts zahlen. Tony, ein Mitarbeiter, der Bestellungen verarbeitet, erstellt eine Rechnung, sobald er eine Bestellung erhält. Sobald die Rechnung erstellt wurde, wird dem Kunden eine SMS gesendet, die ihm dankt für die Bestellung und eine Referenznummer enthält.
Voraussetzungen:
- Konto bei SMS-Gateway-Dienstleister
- Berechtigung zum Zugriff auf Workflow-Regeln
Verfahren:
- Erstellen Sie ein Konto bei einem SMS-Gateway-Dienstleister.
- Konfigurieren Sie einen Webhook in Zoho Books.
- Einrichten Sie die Workflow-Regel.
- Testen Sie Ihre Webhook-Integration.
Schritt 1: Erstellen Sie ein Konto bei einem SMS-Gateway-Dienstleister
Erstellen Sie ein Konto bei einem SMS-Gateway-Dienstleister, den Sie wählen. Die Auswahl eines SMS-Gateway-Dienstleisters hängt von verschiedenen Faktoren ab, wie z. B. Land, Zeitzone, Kosten usw.
Nachdem Sie ein Konto beim SMS-Gateway erstellt haben, geben Sie die folgenden Informationen zur Konfiguration des Webhooks an:
- Rechnungsnummer
- Rechnungsdatum
- Rechnungsbetrag
- Telefonnummer Sie können SMS-Kreditkarten erwerben und die API-Daten vom SMS-Anbieter erhalten.
Schritt 2: Webhook in Zoho Books konfigurieren
Beim Einrichten des Webhooks geben Sie die folgenden Angaben an:
URL zum Benachrichtigen: http://api.smsgateway.com/http/sendmsg
Methode: POST
Benutzerdefinierte Parameter:
Wählen Sie beim Einrichten der benutzerdefinierten Parameter die folgenden Felder aus:
- Benutzername
- Passwort
- Auth-Token/API-ID
Benutzerdefinierte Parameter:
Im Abschnitt Entitätsparameter wählen Sie Ausgewählte Parameter anhängen aus; geben Sie den Parametername ein und wählen Sie nach der Auswahl von Kontakte im Dropdown-Menü Handy-Nummer aus.
Klicken Sie auf die Kontrollkästchen Benutzerdefinierte Parameter hinzufügen, geben Sie den Parametername ein (dieses Feld kann je nach Anbieter variieren). Geben Sie die Nachricht in dem bereitgestellten Feld ein und klicken Sie schließlich auf Speichern.
Hinweis: Der Code kann je nach den vom Anbieter erforderlichen Parametern variieren.
Schritt 3: Workflow-Regel einrichten
Folgen Sie den untenstehenden Schritten, um eine Workflow-Regel zu erstellen:
- Wann soll die Aktion ausgelöst werden? Wenn eine Rechnung erstellt wird.
- Unmittelbare Aktion: Wählen Sie den Typ aus dem Dropdown-Menü als Webhook aus und wählen Sie einen Webhook aus dem angrenzenden Feld aus.
Klicken Sie schließlich auf Speichern, um die Workflow-Regel zu speichern.
Schritt 4: Ihr Workflow testen
Testen Sie Ihren Workflow, indem Sie eine neue Rechnung erstellen. Stellen Sie sicher, dass die Felder Kontaktname, Telefonnummer, Rechnungsdatum und Rechnungsbetrag mit korrekten Informationen ausgefüllt sind.
Daher wird bei der Erstellung einer Rechnung ein Workflow ausgelöst, der eine SMS an den Kunden sendet, die ihm dankt und die Bestellung bestätigt.
Zweck: Erstellen eines Potentials in Zoho CRM beim Erstellen eines Angebots
Ein Potential muss für einen Kontakt in Zoho CRM erstellt werden, wenn ein Angebot für ihn oder sie in Zoho Books erstellt wird.
Szenario: Jonathan führt ein Unternehmen namens „Connect-O“ und liefert Computersysteme und Peripheriegeräte in großen Mengen an multinationalen Unternehmen. Ein solches Unternehmen hat ein Angebot für 50 hochwertige Computer und 25 drahtlose Drucker angefordert. Jonathan verwendet Zoho CRM, um Kundendaten zu verwalten und mit ihnen zu interagieren, während er Zoho Books für seine Finanzen nutzt. Er möchte automatisch ein Potential in Zoho CRM erstellen, sobald ein Angebot in Zoho Books erstellt wird.
Voraussetzungen:
- Konto in Zoho CRM und Zoho Books
Verfahren:
- Konfigurieren Sie den Webhook in Zoho Books.
- Erstellen Sie ein Angebot.
- Einrichten Sie eine Workflow-Regel.
- Testen Sie Ihre Webhook-Integration.
Schritt 1: Webhook konfigurieren
Beim Einrichten des Webhooks geben Sie die folgenden Angaben an:
URL zum Benachrichtigen: https://crm.zoho.com/crm/private/xml/Potentials/insertRecords
Methode: POST
Benutzerdefinierte Parameter:
- authtoken: Geben Sie den authtoken aus Ihrem Zoho CRM-Konto an. Melden Sie sich bei Zoho Accounts an, um Ihr authtoken zu erfahren.
Benutzerdefinierte Parameter:
Geben Sie die folgenden Felder aus Zoho Books und Zoho CRM beim Einrichten der benutzerdefinierten Parameter an:
Zoho Books:
- Angebotsnr.
- Kontaktname
- Ablaufdatum
- Angebotsbetrag
Zoho CRM:
- Potentialname
- Konto-Name
- Schließdatum
- Betrag
<Potentials>
<row no="1">
<FL val="Potential Name">${QUOTE.QUOTE_NUMBER}</FL>
<FL val="Account Name">${QUOTE.CONTACT_NAME}</FL>
<FL val="Closing Date">${QUOTE.EXPIRY_DATE}</FL>
<FL val="Amount">${QUOTE.TOTAL}</FL>
<FL val="Stage">Needs Analysis</FL>
</row>
</Potentials>
Hinweis:
- Stellen Sie sicher, dass das Datumformat in Ihrer Zoho Books-Organisation im Format MM/dd/yyyy ist. Sie können das Datumformat aus den Organisationseinstellungen Ihres Zoho Books-Kontos ändern.
- Die oben genannte Liste der Felder ist nicht vollständig. Sie können auch andere Felder aus den Zoho Books- und Zoho CRM-Modulen verwenden. Erinnern Sie sich daran, eine Zeile in der XML-Schnittstelle für jedes zusätzliche Feld einzufügen.
Schritt 2: Erstellen einer Angebotsvorlage
Klicken Sie hier für Informationen zum Erstellen und Senden einer Angebotsvorlage in Zoho Books.
Schritt 3: Workflow-Regel einrichten
Folgen Sie den untenstehenden Schritten, um eine Workflow-Regel zu erstellen:
- Wann soll die Aktion ausgelöst werden? Wenn eine Angebotsvorlage erstellt wird.
- Unmittelbare Aktion: Wählen Sie den Typ als Webhook aus dem Dropdown-Menü und wählen Sie einen Webhook aus dem benachbarten Feld aus.
Klicken Sie schließlich auf Speichern, um die Workflow-Regel zu speichern.
Schritt 4: Ihr Workflow testen
Testen Sie Ihren Workflow, indem Sie eine neue Angebotsvorlage erstellen. Stellen Sie sicher, dass die Felder in Zoho Books und Zoho CRM mit korrekten Informationen ausgefüllt sind.
Daher wird, sobald eine Angebotsvorlage erstellt wird, ein Workflow ausgelöst, um einen Potenzial in Zoho CRM zu erstellen.
Ja
Nein
Vielen Dank für Ihre Rückmeldung!