Tutorial: Erstellen Sie einen Workflow mit HubSpot als Quelle

Ein ausgearbeitetes Beispiel für die Verwendung der Portant Developer API, um einen Workflow mit HubSpot als Quelle zu erstellen. Alle Anfragen verwenden cURL. Ersetzen Sie <DEVELOPER_ACCESS_TOKEN> durch das Token, das Ihnen das Portant-Integrationsteam bereitgestellt hat.

Tipp: Erstellen und führen Sie zunächst einen Workflow in der Portant Workflow-Webanwendung aus, damit Sie mit der Funktionsweise von Workflows vertraut sind. Wir empfehlen eine Google Docs-Vorlage, die außerdem bestätigt, dass Ihr Konto korrekt mit den Google APIs autorisiert ist.

Dieses Tutorial setzt voraus, dass Sie die Schritte im Leitfaden Developers overview abgeschlossen haben und dass Ihr Portant-Konto bereits mit HubSpot verbunden ist.

Schritt 1. Einen Workflow erstellen

Wir nennen den Workflow "Developer Workflow" und erstellen ihn mit dem Endpunkt Workflows POST, wobei eine HubSpot-Quelle übergeben wird.

curl --location --request POST 'https://api.portant.co/v0/workflows/' \
--header 'Authorization: <DEVELOPER_ACCESS_TOKEN>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Developer Workflow",
    "source": {
        "sourceType": "HUBSPOT",
        "hubspotObjectTypeId": "0-3",
        "hubspotProperties": ["0-3.dealname", "0-1.firstname"]
    }
}'

Eine HubSpot-Quelle erfordert neben sourceType zwei zusätzliche Felder:

hubspotObjectTypeId (String) Der primäre HubSpot-Objekttyp für diesen Workflow. Dabei wird die eigene Objekttyp-ID-Konvention von HubSpot verwendet: 0-3 ist beispielsweise die Objekttyp-ID für Deals. Die vollständige Liste finden Sie in der HubSpot-Referenz für object type ID reference.

hubspotProperties (Array<String>) Die Eigenschaften, die als Quellfelder für diesen Workflow einbezogen werden sollen, jeweils im Format <objectTypeId>.<internalFieldName>, wobei objectTypeId die oben genannte Typ-ID und internalFieldName der interne Name der jeweiligen Eigenschaft in HubSpot ist. Im obigen Beispiel ruft 0-3.dealname den Deal-Namen und 0-1.firstname den Vornamen des zugehörigen Kontakts ab.

Eine erfolgreiche Anfrage gibt 201 Created mit dem neuen Workflow zurück. Speichern Sie den Wert id, da Sie ihn benötigen, um im nächsten Schritt eine Vorlage hinzuzufügen.

Schritt 2. Eine Vorlage hinzufügen und den Workflow aktivieren

Von hier an verhält sich der Workflow wie jeder andere. Die verbleibenden Schritte sind identisch mit dem Webhook-Tutorial:

Create a template document (Vorlagendokument erstellen), um die Datei hinzuzufügen, die zusammengeführt wird.
Listen for automation events (Auf Automatisierungsereignisse warten), um benachrichtigt zu werden, wenn Dokumente erstellt werden.

Sobald der Workflow sowohl eine HubSpot-Quelle als auch mindestens eine Vorlage hat, wird sein status zu "COMPLETE" und er wird ausgeführt, wenn ein passendes HubSpot-Objekt ihn auslöst.

Weitere Informationen zu allen Endpunkten und Ressourcen finden Sie in der übrigen API-Referenz. Wenn Sie Fragen oder Funktionsanfragen haben, wenden Sie sich an das Customer-Success- oder Integrationsteam.