Tutorial: Een workflow maken met HubSpot als bron

Een uitgewerkt voorbeeld van het gebruik van de Portant Developer API om een workflow te maken met HubSpot als bron. Alle verzoeken gebruiken cURL. Vervang <DEVELOPER_ACCESS_TOKEN> door het token dat het Portant-integratieteam u heeft gegeven.

Tip: bouw en voer een workflow uit in de Portant Workflow-webapplicatie voordat u begint, zodat u vertrouwd raakt met hoe workflows werken. Wij raden een Google Docs-sjabloon aan, waarmee u ook bevestigt dat uw account correct is geautoriseerd bij de API's van Google.

Deze tutorial gaat ervan uit dat u de stappen in de handleiding Developers overview (ontwikkelaarsoverzicht) hebt voltooid en dat uw Portant-account al is verbonden met HubSpot.

Stap 1. Een workflow maken

We geven de workflow de naam "Developer Workflow" en maken deze aan via het eindpunt Workflows POST (workflows aanmaken), waarbij we een HubSpot-bron meegeven.

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"]
    }
}'

Een HubSpot-bron vereist twee extra velden naast sourceType:

hubspotObjectTypeId (String) Het primaire HubSpot-objecttype voor deze workflow. Dit maakt gebruik van de eigen objecttype-ID-conventie van HubSpot: 0-3 is bijvoorbeeld de objecttype-ID voor Deals. Raadpleeg de referentie voor objecttype-ID's van HubSpot voor de volledige lijst.

hubspotProperties (Array<String>) De eigenschappen die als bronvelden voor deze workflow worden opgenomen, elk in de indeling <objectTypeId>.<internalFieldName>, waarbij objectTypeId de bovenstaande type-ID is en internalFieldName de interne naam van die eigenschap in HubSpot. In het bovenstaande voorbeeld haalt 0-3.dealname de dealnaam op en haalt 0-1.firstname de voornaam van de gekoppelde contactpersoon op.

Een geslaagd verzoek geeft 201 Created terug met de nieuwe workflow. Sla de waarde van id op. U hebt deze nodig om vervolgens een sjabloon toe te voegen.

Stap 2. Een sjabloon toevoegen en live gaan

Vanaf dit punt gedraagt de workflow zich zoals elke andere. De resterende stappen zijn identiek aan de Webhook-tutorial:

• Create a template document (een sjabloondocument aanmaken) om het bestand toe te voegen dat wordt samengevoegd.
• Listen for automation events (luisteren naar automatiseringsgebeurtenissen) om een melding te ontvangen wanneer documenten worden aangemaakt.

Zodra de workflow zowel een HubSpot-bron als ten minste één sjabloon heeft, wordt de status "COMPLETE" en wordt de workflow uitgevoerd telkens wanneer een overeenkomend HubSpot-object deze activeert.

Raadpleeg de rest van de API-referentie voor details over elk eindpunt en elke resource. Neem contact op met het customer success- of integratieteam als u vragen of functieverzoeken heeft.