Vidensbase

Forbind HubSpot og OneSignal

Skrevet af HubSpot Support | Jun 28, 2023 1:49:35 PM

Med OneSignal-integrationen kan du oprette og sende OneSignal push-notifikationer ved hjælp af workflows, se push-notifikationer på kontakters aktivitetstidslinjer og segmentere brugere baseret på engagement med push-notifikationer.

Krav til integrationen

Forbind appen

  • Brug søgefeltet til at finde og vælge OneSignal-integrationen.
  • Klik på Installer app øverst til højre.
  • Log ind på din OneSignal-konto.
  • I pop-up boksen skal du indtaste dit applikations-id og API-nøgle fra din OneSignal-konto.
  • Klik om nødvendigt på Tilføj applikation for at tilføje en anden applikation.
  • Klik på Installer app.
  • Du vil blive omdirigeret til siden Connected apps.

Match din OneSignal-bruger med din HubSpot-bruger

Integrationen kræver, at du matcher din OneSignal-bruger med HubSpot-kontakter. Brugere har to muligheder for at matche:

  • Efter e-mailadresse: Brugere skal bruge OneSignals setEmail-funktion ved hjælp af deres SDK til at knytte OneSignal-brugere til e-mailadresser. Denne matchningsmulighed er kun tilgængelig for workflow-handlingen Send OneSignal-notifikation.
  • Ved OneSignal external_user_id: Brugerne skal vælge den HubSpot-kontaktegenskab, de ønsker at matche med external_user_id i OneSignal. For at gøre det:
    • Klik på OneSignal.
    • Klik på Contact Matching.
    • Vælg den HubSpot-kontaktegenskab, du vil bruge til at matche med OneSignals external_user_id-egenskab, i dropdown-menuen. Denne matchningsmulighed er tilgængelig for både workflowhandlingerne Send OneSignal-meddelelser og Rediger OneSignal-tags.

Automatiser OneSignal push-meddelelser

Du kan automatisere afsendelse af OneSignal-pushnotifikationer ved hjælp af workflows.

  • Klik på Opret workflow øverst til højre.
  • Vælg Kontaktbaseret i venstre panel, og klik på Næste øverst til højre.
  • Indstil dine tilmeldingsudløsere.
  • Klik på + plus-ikonet for at tilføje en handling.
  • I højre panel skal du vælge Send OneSignal-notifikation.
  • Klik på dropdown-menuen Vælg app for at vælge dine forbundne OneSignal-apps.


  • Klik på rullemenuen Vil du bruge en eksisterende OneSignal Push-skabelon eller oprette et nyt push? og vælg en skabelonmulighed:
    • Hvis du vil vælge en eksisterende skabelon, skal du klikke på Brug skabeloner.
    • Hvis du vil oprette en ny skabelon, skal du klikke på Brug brugerdefineret konfiguration og udfylde de nødvendige felter. Du kan bruge personaliseringstokens i disse felter.
  • Klik på Gem.
  • Du kan tilføje yderligere handlinger til dit workflow.
  • Når du er færdig med at konfigurere dit workflow, skal du klikke på Gennemse øverst til højre.
  • Gennemgå opsætningen af dit workflow, og klik på Tænd øverst til højre.
Push-notifikationen vises som en aktivitet på kontaktpostens tidslinje.


Automatiser OneSignal-tags til at udløse meddelelser i appen

Brug workflows til at udløse in-app-beskeder i din OneSignal-app.

  • Klik på Opret workflow øverst til højre.
  • Vælg Kontaktbaseret i panelet til venstre, og klik derefter på Næste øverst til højre.
  • Indstil dine tilmeldingsudløsere.
  • Klik på + plus-ikonet for at tilføje en handling.
  • Vælg Rediger OneSignal-tags i panelet til højre.

  • Klik på dropdown-menuerne Select App for at vælge dine forbundne OneSignal-apps.
  • Indtast JSON-strengen med { "key" : "value" } par, som du ønsker at redigere. Få mere at vide om at bruge OneSignal-datatags.
  • Klik på Gem.
  • Du kan tilføje yderligere handlinger til dit workflow.
  • Når du er færdig med at opsætte dit workflow, skal du klikke på Gennemse øverst til højre.
  • Gennemgå opsætningen af dit workflow, og klik på Tænd.

Redigering af OneSignal-tags kan også aktivere meddelelser i appen i OneSignal. Se OneSignals vejledning for trin til, hvordan du gør det.

Brug HubSpot-formularindsendelser til at linke HubSpot-kontakter til OneSignal-brugere

For at bruge denne funktionalitet skal du sikre dig, at du har den relevante kode fra dine OneSignal Web Push-indstillinger tilføjet til head HTML på dine sider.

Du har to muligheder for at indfange og sende e-mailadresser til OneSignal:

  1. Placer følgende globalt i din <head> ... </head> for at anvende det på tværs af formularindsendelser:

window.addEventListener('message', event => {
if(event.data.type === 'hsFormCallback' && event.data.eventName === 'onFormSubmit') {
OneSignal.push(function() {
OneSignal.setEmail($("input[name=email]").val())
.then(function(emailId) {
// Callback called when email have finished sending
console.log("emailId: ", emailId);
});
}
});

  1. Rediger embed-scriptet for en af dine HubSpot-formularer direkte. Du bliver nødt til at indsætte dit portal-ID og formular-ID fra din konto. Her er et eksempel:

    <script charset="utf-8" type="text/javascript" src="//js.hsforms.net/forms/v2.js"></script>
    <script>
    hbspt.forms.create({
    region: "na1",
    portalId: "YOUR PORTAL ID",
    formId: "YOUR FORM ID",
    onFormSubmit: function($form) {
    OneSignal.push(function() {
    OneSignal.setEmail($("input[name=email]").val())
    .then(function(emailId) {
    // Callback called when email have finished sending
    console.log("emailId: ", emailId);
    });
    });
    }
    });
    </script>