Konfigurera en anpassad provider sms-configuration-custom

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 både SMS- och RCS-meddelanden.

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 SMS- och RCS-meddelanden i Journey Optimizer med en anpassad leverantör som inte är tillgänglig direkt från Adobe (t.ex. Sinch, Infobip, Twilio):

  1. 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.

  2. 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 din SMS-leverantör har angett.

    • Provider Name: Ange namnet på SMS-providern.

    • 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.

  3. 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.

  4. 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.

  5. 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.

  6. Klicka på Submit när du är klar med konfigurationen av dina API-autentiseringsuppgifter.

  7. Klicka på API Credentials bin-ikonen på menyn för att ta bort dina API-autentiseringsuppgifter.

  8. 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.

  9. 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.

  10. 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

API-nyckel

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 din SMS-leverantör tillhandahåller.

MAC-autentisering

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 din SMS-leverantör tillhandahåller.
  • 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.

OAuth-autentisering

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 din SMS-leverantör tillhandahåller.

  • OAuth URL ​: Ange URL:en för att hämta OAuth-token.

  • OAuth Body ​: Ange OAuth-begärandetexten i JSON-format, inklusive parametrar som grant_type, client_id och client_secret.

JWT-autentisering

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 din SMS-leverantör tillhandahåller.

  • JWT Payload ​: Ange JSON-nyttolasten som innehåller de anspråk som krävs för JWT, till exempel utfärdare, ämne, målgrupp och utgångsdatum.

Skapa webkrok webhook

recommendation-more-help

Om nyckelord för anmälan eller avanmälan inte anges används standardmeddelanden för godkännande för att respektera användarens integritet. Om du lägger till anpassade nyckelord åsidosätts standardvärdena automatiskt.

Standardnyckelord:

  • Opt-In: SUBSCRIBE, YES, UNSTOP, START, FORTSÄTT, RESUME, BEGIN
  • Opt-Out: STOP, QUIT, CANCEL, END, UNSUBSCRIBE, NO
  • Hjälp: HJÄLP

När API-autentiseringsuppgifterna har skapats är nästa steg att skapa en webkrok och konfigurera dina inkommande inställningar. Den här konfigurationen ser till att systemet kan ta emot och bearbeta inkommande data eller meddelanden på rätt sätt.

När du konfigurerar en webkrok kan du definiera dess syfte baserat på den typ av data som du vill hämta:

  • Inbound: Använd det här alternativet om du vill samla in medgivandesvar, t.ex. anmälan eller avanmälan, och samla in användarinställningar.

  • Feedback: Välj det här alternativet om du vill spåra leverans- och engagemangshändelser, inklusive läskvitton och användarinteraktioner, som stöd för rapportering och analys.

Inkommande
  1. Navigera till Administration > Channels i den vänstra listen, välj menyn SMS Webhooks under SMS settings och klicka på knappen Create Webhook.

  2. Konfigurera webkrosinställningarna enligt anvisningarna nedan:

    • Name: Ange ett namn för din webkrok.

    • Select SMS vendor: Anpassad.

    • Type: Inkommande.

    • API credentials: Välj i listrutan tidigare konfigurerade API-autentiseringsuppgifter.

    • Sender Phone Number ​: Ange det ​ för avsändarens telefonnummer som du vill använda för kommunikationen.

  3. Klicka på för att lägga till dina nyckelordskategorier och konfigurera dem sedan så här:

    • Inbound Keyword Category: Välj dina nyckelordskategorier antingen Opt-In, Opt-Out, Help eller Default.

    • Enter a keyword: Ange standardnyckelord eller anpassade nyckelord som automatiskt kommer att utlösa ditt meddelande. Klicka på om du vill lägga till flera nyckelord.

    • Reply Message: Välj det anpassade svar som skickas automatiskt i listrutan.

  4. Klicka på View payload editor för att validera och anpassa dina begärandataströmmar.

    Du kan dynamiskt anpassa din nyttolast med hjälp av profilattribut och säkerställa att korrekta data skickas för bearbetning och svarsgenerering med hjälp av inbyggda hjälpfunktioner.

  5. Klicka på Submit när du är klar med konfigurationen av din webkrok.

  6. Klicka på ikonen Webhooks bin på menyn för att ta bort webkroken.

  7. Om du vill ändra den befintliga konfigurationen letar du reda på önskad webbkrok och klickar på alternativet Edit för att göra de ändringar som behövs.

  8. Få åtkomst till och kopiera din nya Webhook URL från din tidigare inskickade Webhook.

När du har skapat och konfigurerat inställningarna för inkommande trafik för webkroken måste du nu skapa en kanalkonfiguration för SMS-meddelanden.

När konfigurationen är klar kan ni utnyttja alla färdiga kanalfunktioner som meddelandeframställning, personalisering, länkspårning och rapportering.

Feedback
  1. Navigera till Administration > Channels i den vänstra listen, välj menyn SMS Webhooks under SMS settings och klicka på knappen Create Webhook.

  2. Konfigurera webkrosinställningarna enligt anvisningarna nedan:

    • Name: Ange ett namn för din webkrok.

    • Select SMS vendor: Anpassad.

    • Type: Feedback.

  3. Klicka på View payload editor för att validera och anpassa dina begärandataströmmar.

    Du kan dynamiskt anpassa din nyttolast med hjälp av profilattribut och säkerställa att korrekta data skickas för bearbetning och svarsgenerering med hjälp av inbyggda hjälpfunktioner.

  4. Klicka på Submit när du är klar med konfigurationen av din webkrok.

  5. Klicka på ikonen Webhooks bin på menyn för att ta bort webkroken.

  6. Om du vill ändra den befintliga konfigurationen letar du reda på önskad webbkrok och klickar på alternativet Edit för att göra de ändringar som behövs.

  7. Få åtkomst till och kopiera din nya Webhook URL från din tidigare inskickade Webhook.

När du har skapat och konfigurerat inställningarna för inkommande trafik för webkroken måste du nu skapa en kanalkonfiguration för SMS-meddelanden.

När konfigurationen är klar kan ni utnyttja alla färdiga kanalfunktioner som meddelandeframställning, personalisering, länkspårning och rapportering.

Instruktionsvideo video

b22c9c5d-9208-48f4-b874-1cefb8df4d76