Use the New Sequences API to Get Sequences Data and Enroll Contacts

Hallo zusammen, hier ist Brooke von HubSpot. Heute erkläre ich Ihnen, wie Sie die Sequenz API nutzen können, um Daten zu all Ihren öffentlichen Sequenzen in Ihrem Account abzurufen und Kontakte mit Hilfe der API in Sequenzen aufzunehmen. So können Sie Kontakte aus externen Datenquellen in Ihre HubSpot Sequenz aufnehmen. Um diese API zu nutzen, sehen wir uns zunächst an, wie sequenzen in Ihrem HubSpot Account verwendet werden. Bewegen Sie den Mauszeiger in der Hauptnavig über Automatisierungen und klicken Sie dann auf Sequenzen. Hier sehen Sie eine Liste aller Ihrer Sequenzen, die für Sie öffentlich und privat sind. Um diese API nutzen zu können, müssen Ihre Sequenzen öffentlich sein. Private Sequenzen werden beim Abrufen von Daten über diese API nicht angezeigt. Um eine neue Sequenz zu erstellen, klicken Sie auf Sequenz erstellen. Anschließend sehen Sie verschiedene Optionen zum Erstellen einer Sequenz. Beginnen wir mit einer vorgefertigten Sequenz. Nehmen wir an, es handelt sich um eine Veranstaltungsnachverfolgung. Das ist ideal, wenn Sie eine Veranstaltung veranstaltet haben und Teilnehmer, Nichtteilnehmer usw. Erreichen und Ihnen weitere Informationen geben möchten. Nachdem Sie Ihre Sequenz ausgewählt haben, klicken Sie auf Sequenz erstellen. In diesem Bereich können Sie weitere Schritte hinzufügen und automatisieren. Sie können auch App Tests hinzufügen, um verschiedene E Mail Versionen zu erstellen. Für die Verwendung der Sequenz API benötigen Sie die Benutzer ID des Sequenzinhabers. Hier oben sehen Sie, wer der Inhaber ist. In diesem Fall bin ich der Inhaber, daher muss ich meine Benutzer ID im API Aufruf verwenden, um diese Sequenz abzurufen. Klicken wir also auf Speichern. Behalten wir den Sequenznamen bei. Stellen wir dann sicher, dass alle Benutzer die Sequenz sehen können, damit sie öffentlich ist. Klicken wir nun auf Speichern. Super. Wir haben unsere Sequenz erstellt. Jetzt holen wir uns meine Benutzer ID, denn die benötigen wir für den AP Aufruf. Anschließend rufen wir unsere Postman Sammlung auf, um diese Aufrufe durchzuführen. Um eine Benutzer ID in Ihrem Konto zu finden, gehen Sie in die obere Navigation und klicken Sie auf Einstellungen. Klicken Sie anschließend auf Benutzer Teams. Klicken Sie anschließend auf den gewünschten Benutzer. Ich klicke einfach auf Ich selbst. Jetzt holen wir uns die Benutzer ID aus der URL. Sie können diesen Prozess jedoch automatisieren, indem Sie die Benutzer API verwenden. Um jede beliebige Benutzer ID abzurufen, klicken wir einfach hier auf die URL, holen uns diese Benutzer ID und kopieren sie. Super. Gehen wir nun zu Postman. Wir befinden uns im von HubSpot erstellten öffentlichen API Arbeitsbereich innerhalb von Postman. Hier finden Sie Sammlungen für alle unsere öffentlichen APIs. Die Sequences API ist Teil unserer Automation API. Wir öffnen die Automation API Sammlung, indem wir mit der Maus darüberfahren, auf die drei Punkte klicken und Fork erstellen. Ausw. Wir benennen sie als Automation Fork. Sehen wir uns die ursprüngliche Sammlung an. Klicken wir nun auf Fork Sammlung. Super. Wir haben jetzt unsere eigene geforkte Version dieser API. Ich öffne den Ordner und gehe zur Sequenzs API. Ich fahre mit der Maus über den Automation API Ordner und klicke auf das Symbol. Wir sehen den Sequences API Ordner. Öffnen wir ihn ebenfalls, indem wir auf das Symbol klicken. Wir sehen zwei verschiedene Public Enrollments und Public Sequences. Öffentliche Registrierungen ermöglichen es Ihnen, Kontakte zu öffentlichen Sequenzen hinzuzufügen und öffentliche Sequenzen ermöglichen Ihnen, Daten zu verschiedenen Sequenzen abzurufen. Lassen Sie uns zunächst Daten zu verschiedenen Sequenzen abrufen. Öffnen Sie dazu den Ordner Öffentliche Sequenzen. Wir sehen hier zwei GET Aufrufe. Der erste ruft eine Sequenz mit Hilfe der Benutzer ID und weiterer Abfrageparameter ab, die Sie mitsenden, wie z. B. Afterlimit und Name. Diese sind alle optional. Die Benutzer ID ist nicht optional. Der zweite Getaufruf ermöglicht Ihnen, eine Sequenz anhand der Sequenz ID sowie der Benutzer ID abzurufen, deren Eigentümer diese Sequenz ist. Rufen wir zunächst alle Sequenzen ab, die ich besitze. Als erstes müssen wir die Basis URL festlegen. Klicken Sie einfach darauf. Wenn Sie mit der Maus darüberfahren, wird Ihnen angezeigt, dass Sie den Wert eingeben sollen. Dies ist unsere. Klicken Sie nun auf Zur Sammlung hinzufügen. Dies gilt für alle Aufrufe innerhalb der Automation AP Sammlung. Fügen wir nun die Benutzer ID ein, die ich mir selbst erstellt habe. Deaktivieren wir die Optionen Limit und Name. Nachdem wir alles eingerichtet haben, wechseln wir zum Autorisierungstabelle. Hier verwenden wir einen privaten App Token. Wir ändern ihn von API Schlüssel in Bera Token. Anschließend generieren wir in unserem HubSpot Konto einen neuen U Token. Klicken wir in der oberen Navigation auf das Einstellungssymbol, scrollen wir nach unten, bis wir Integrationen sehen. Dort wählen wir Private Apps. Auf dieser Seite mit den privaten Apps erstellen wir nun eine private App. Nennen wir sie Sequences API. Gehen wir dann zu den Scopes. Damit das funktioniert, fügen wir unseren neuen Scope hinzu und suchen nach Sequenzes. Klicken wir auf die Sequenzregistrierungen. Die Sequenzen werden gelesen. So können wir später Kontakte hinzufügen und aktualisieren. Klicken wir nun auf App erstellen im Pop up Fenster, klicken wir auf Erstellen Fortsetzen. Anschließend klicken wir auf Token anzeigen und kopieren das. Anschließend schließen wir das Fenster. Nachdem wir nun unser Token haben, gehen wir zurück zu Postman. OK. In Postman fügen wir unser Token ein. Jetzt können wir den Anruf tätigen. Klicken wir einfach auf Senden. Wir sehen, dass wir eine 200 haben. Alle Daten haben also funktioniert. Sehen wir uns nun die Daten an. Sie zeigen Ihnen, wie viele öffentliche Sequenzen Sie haben, sowie die ID, den Namen der Sequenz, das Erstellungsdatum und die Benutzer ID des Erstellers. Das sind also nicht viele Daten, mit denen Sie arbeiten können. Sehen wir uns also an, was passiert, wenn wir den anderen Getaufruf verwenden. Dazu nehmen wir eine dieser Sequenz IDs. Da wir sie für unseren Aufruf benötigen. Wechseln wir dann zum anderen Aufruf. Fügen wir innerhalb dieser Pfadvariable unsere Sequenz ID hinzu. Außerdem müssen wir weiterhin die Benutzer ID verwenden, die wir beim letzten Mal verwendet haben. In unserer Abfrage prem Fügen wir daher unseren Benutzer ID Wert hinzu. Stellen wir sicher, dass unsere Autorisierung eingerichtet ist. Wir ändern dies ebenfalls in Bear Token. Dadurch wird unser Token aus dem anderen Aufruf beibehalten, sodass wir ihn nicht lesen müssen. Klicken wir nun auf Senden, sehen wir uns an, wie sich dieses Ergebnis von dem anderen unterscheidet. Dieses Ergebnis zeigt Ihnen die Schritte dieser Sequenz. Dieser Aufruf enthält außerdem einige Einstellungsinformationen zur Sequenz sowie zu Abhängigkeiten. Wie Sie sehen, ist dieser Get it Aufruf deutlich detaillierter für eine bestimmte Sequenz und ermöglicht Ihnen, deutlich mehr Daten zu dieser Sequenz abzurufen. Der andere Aufruf listet hingegen nur die verschiedenen öffentlichen Sequenzen eines einzelnen Inhabers auf. Sehen wir uns nun an, wie wir diese API nutzen können, um einen Kontakt in eine Sequenz einzutragen. Öffnen wir dazu den Ordner Public Enrollments. Dort finden wir zwei einen Getaufruf, um alle aktuell in einer Sequenz eingetragenen Benutzer abzurufen, und einen Post Aufruf, um jemanden zu einer neuen Sequenz hinzuzufügen. Sehen wir uns also den Post Aufruf an. Für diese API benötigen wir die Benutzer ID des Sequenzinhabers. Fügen wir also meine Benutzer ID ein. Anschließend legen wir die Autorisierung fest. Auch hier verwenden wir einfach unseren VERA Token. Im Textkörper senden wir die Informationen zu der Person, die wir registrieren möchten. Für diesen Anruf benötigen wir die Kontakt ID aus Ihrem HubSpot Konto, die E Mail Adresse des Absenders und die Sequenz ID. Gehen wir also zurück zu unserem HubSpot Konto. Um die Kontakt ID abzurufen, bewegen Sie den Mauszeiger in der Hauptnavigation über CRM und klicken Sie auf Kontakte. Registrieren wir uns in der URL. Erfassen wir nun meine Datensatz ID. Nachdem wir diese haben, gehen wir zurück zu Postman. Fügen wir dort die Kontakt ID ein und senden den Absender als meinen. Zum Schluss holen wir uns die Sequenz ID. Wir verwenden die Sequenz ID der Veranstaltungs Follow up Nachverfolgung. Die haben wir nun. Gehen wir zurück zu unserer Post Anfrage und fügen sie ein. Nachdem wir nun alle Informationen haben, klicken wir auf Senden und Super, ich wurde für diese Sequenz registriert. Sehen wir uns die Sequenz in unserem unternehmensweiten Account an. Gehen wir zurück zu Automatisierungen und Sequenzen in unserer Event Nachverfolgung. Sollten wir nun eine Registrierung von einem Nutzer sehen, klicken wir einfach darauf und wählen Sie den Nutzer aus. So haben wir die Sequenzen API verwendet, um die öffentlichen Sequenzen unseres Accounts abzurufen und neue Nutzer über den API Aufruf zur Sequenz hinzuzufügen. Das ist sehr hilfreich, wenn Sie Kontakte von Drittanbietern in HubSpot Sequenzen registrieren möchten. Wie immer finden Sie alle Links zu dieser Dokumentation unten im Beschreibungsfeld. Schauen Sie also unbedingt vorbei. Vielen Dank fürs Zuschauen. Liken und Abonnieren Sie den YouTube Kanal der HubSpot Developers. Wir sehen uns in einem anderen Video.