Portant Docs
Page d'accueil Installer dans HubSpot Commencer gratuitement

Tutoriel : Créer un workflow avec HubSpot comme source

Un exemple concret d'utilisation de l'API Portant Developer pour créer un workflow avec HubSpot comme source. Toutes les requêtes utilisent cURL. Remplacez <DEVELOPER_ACCESS_TOKEN> par le jeton que l'équipe d'intégrations Portant vous a fourni.

Conseil : avant de commencer, créez et exécutez un workflow dans l'application web Portant Workflow afin de vous familiariser avec le fonctionnement des workflows. Nous recommandons un modèle Google Docs, ce qui confirme également que votre compte est correctement autorisé auprès des API de Google.

Ce tutoriel suppose que vous avez terminé les étapes décrites dans le guide Présentation pour les développeurs, et que votre compte Portant est déjà connecté à HubSpot.

Étape 1. Créer un workflow

Nous allons nommer le workflow "Developer Workflow" et le créer avec l'endpoint Workflows POST, en passant une source HubSpot.

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

Une source HubSpot requiert deux champs supplémentaires en plus de sourceType :

hubspotObjectTypeId (String) Le type d'objet HubSpot principal pour ce workflow. Ce champ utilise la convention d'identifiant de type d'objet propre à HubSpot : 0-3, par exemple, est l'identifiant de type d'objet pour les Deals. Consultez la référence des identifiants de type d'objet de HubSpot pour la liste complète.

hubspotProperties (Array<String>) Les propriétés à inclure en tant que champs sources pour ce workflow, chacune au format <objectTypeId>.<internalFieldName>, où objectTypeId est l'identifiant de type mentionné ci-dessus et internalFieldName est le nom interne de cette propriété dans HubSpot. Dans l'exemple ci-dessus, 0-3.dealname récupère le nom du deal et 0-1.firstname récupère le prénom du contact associé.

Une requête réussie retourne 201 Created avec le nouveau workflow. Enregistrez la valeur id ; vous l'utiliserez pour ajouter un modèle à l'étape suivante.

Étape 2. Ajouter un modèle et mettre en ligne

À partir de là, le workflow se comporte comme n'importe quel autre. Les étapes restantes sont identiques à celles du tutoriel sur les webhooks :

Une fois que le workflow dispose d'une source HubSpot et d'au moins un modèle, son status passe à "COMPLETE" et il s'exécute chaque fois qu'un objet HubSpot correspondant le déclenche.

Pour obtenir des détails sur chaque endpoint et ressource, parcourez le reste de la référence API. Si vous avez des questions ou des demandes de fonctionnalités, contactez l'équipe chargée du succès client ou l'équipe d'intégrations.