På den här sidan: Lär dig hur du integrerar en anpassad meddelandeleverantör i Adobe Journey Optimizer genom att skapa API-autentiseringsuppgifter, välja en autentiseringsmetod och konfigurera rubriker, nyttolaster och inkommande inställningar för att skicka SMS- och RCS-meddelanden.
Med den här funktionen kan du integrera och konfigurera dina egna meddelandeleverantörer och erbjuda flexibilitet utöver standardalternativen (Sinch, Twilio och Infobip). Detta möjliggör smidig redigering, leverans, rapportering och samtyckeshantering för mobilmeddelanden.
Med anpassad leverantörskonfiguration kan du ansluta tredjepartstjänster direkt inifrån Journey Optimizer, anpassa meddelandenyttolaster för dynamiskt innehåll och hantera inställningar för anmälan/avanmälan för att säkerställa regelefterlevnad i både SMS- och RCS-kanaler.
Följ stegen nedan för att konfigurera din anpassade leverantör:
Skapa API-autentiseringsuppgifter api-credential
Följ de här stegen för att skicka mobilmeddelanden i Journey Optimizer med en anpassad leverantör som inte är tillgänglig från Adobe (t.ex. Sinch, Infobip, Twilio):
-
Navigera till Administration
>Channels i den vänstra listen, välj menyn API Credentials under SMS settings och klicka på knappen Create new API credentials.
-
Konfigurera dina SMS API-autentiseringsuppgifter enligt nedanstående:
-
SMS vendor: Anpassad.
-
Name: Ange ett namn för API-autentiseringsuppgifterna.
-
Provider AppId: Ange det program-ID som du fått från din SMS-leverantör.
-
Provider Name: Ange namnet på din SMS-leverantör.
-
Provider URL: Ange URL:en till din SMS-leverantör.
-
Auth Type: Välj auktoriseringstyp och fyll i motsvarande fält baserat på den valda autentiseringsmetoden.
-
-
Aktivera alternativet mTLS support, som ser till att både klienten och servern autentiserar varandra innan en säker anslutning upprättas.
Om du bara vill använda mTLS väljer du No Authentication i listrutan Auth Type och aktiverar sedan mTLS support.
Observera att mTLS bara gäller för slutpunkten för SMS-providern (meddelandesändning). OAuth-tokenslutpunkten får inte använda mTLS. Kontrollera att mTLS är inaktiverat på tokenslutpunkten före testning.
note important IMPORTANT Konfigurera SMS-sändningens slutpunkt så att den litar på Adobe Experience Platform certifikatutfärdarkedja genom att hämta det offentliga certifikatet från MTLS Public Certificate API och lägga till det i serverns förtroendearkiv (förväntat klient-CN: ajo-sms.aep-mtls.adobe.com), annars utelämnar Journey Optimizer klientcertifikatet och SMS-leveransen misslyckas. -
I avsnittet Headers klickar du på Add new parameter för att ange HTTP-rubriker för det begärandemeddelande som ska skickas till den externa tjänsten.
Rubrikfälten Content-Type och Charset är inställda som standard och kan inte tas bort.
-
Lägg till din Provider Payload för att validera och anpassa dina begärda nyttolaster.
För RCS-meddelanden används den här nyttolasten senare under innehållsdesign.
note NOTE När du konfigurerar en anpassad SMS-provider med Basic- eller Bearer-autentisering måste du inkludera parametern authOptioni JSON-nyttolasten. Dessutom måste providernyttolasten referera till mallvariablerna{{fromNumber}},{{toNumber}}och{{message}}. -
Välj Use custom dataset for inbound om du vill dirigera den här autentiseringsuppgiftens inkommande SMS till en redan skapad datauppsättning som du väljer i listrutan. Läs mer om hur du använder en anpassad datauppsättning för inkommande nyckelord
note NOTE Datamängdsschemat måste vara XDM ExperienceEvent och innehålla minst följande fältgrupper: - Adobe CJM ExperienceEvent - Information om meddelandeinteraktion
- Adobe CJM ExperienceEvent - Information om meddelandekörning
- Adobe CJM ExperienceEvent - Information om meddelandeprofil
Schemat och datauppsättningen måste aktiveras för profilen. -
Klicka på Submit när du är klar med konfigurationen av dina API-autentiseringsuppgifter.
-
Klicka på
på menyn API Credentials för att ta bort dina API-autentiseringsuppgifter.
-
Om du vill ändra befintliga autentiseringsuppgifter letar du reda på de API-autentiseringsuppgifter du vill ha och klickar på alternativet Edit för att göra de ändringar som behövs.
-
Klicka på Verify SMS connection, bland dina befintliga API-autentiseringsuppgifter, för att testa och verifiera dina SMS API-autentiseringsuppgifter genom att skicka ett exempelmeddelande till en angiven enhet.
-
Fyll i fälten Number och Message och klicka på Verify connection.
note important IMPORTANT Meddelandet måste vara strukturerat så att det överensstämmer med leverantörens nyttolastformat.
När du har skapat och konfigurerat API-autentiseringsuppgifterna måste du nu konfigurera inställningarna för inkommande trafik för Webkrok för SMS-meddelanden.
Autentiseringsalternativ för anpassade SMS-providers auth-options
När API-autentiseringsuppgifterna har skapats fyller du i de fält som krävs för API-nyckelautentisering:
- Name : Ange ett namn för API-nyckelkonfigurationen.
- API Token : Ange den API-token som tillhandahålls av din SMS-leverantör.
När API-autentiseringsuppgifterna har skapats fyller du i de fält som krävs för MAC-autentisering:
- Name : Ange ett namn för din MAC-autentiseringskonfiguration.
- API Token : Ange den API-token som tillhandahålls av din SMS-leverantör.
- API Secret Key: Ange API-hemlig nyckel från din SMS-leverantör. Den här nyckeln används för att generera MAC (Message Authentication Code) för säker kommunikation.
- Mac Authorization Hash Format: Välj hash-format för MAC-autentiseringen.
När API-autentiseringsuppgifterna har skapats fyller du i fälten som krävs för OAuth-autentisering:
-
Name : Ange ett namn för OAuth-autentiseringskonfigurationen.
-
API Token : Ange den API-token som tillhandahålls av din SMS-leverantör.
-
OAuth URL : Ange URL:en för att hämta OAuth-token.
-
OAuth Body : Ange texten för OAuth-begäran i JSON-format, inklusive parametrar som
grant_type,client_idochclient_secret.
Journey Optimizer uppdaterar OAuth-tokens dynamiskt när det går ut för den anpassade SMS-kopplingen.
När API-autentiseringsuppgifterna har skapats fyller du i fälten som krävs för JWT-autentisering:
-
Name : Ange ett namn för JWT-autentiseringskonfigurationen.
-
API Token : Ange den API-token som tillhandahålls av din SMS-leverantör.
-
JWT Payload : Ange JSON-nyttolasten som innehåller de anspråk som krävs för JWT, t.ex. utfärdare, ämne, målgrupp och utgångsdatum.