DM Champ Docs

GoHighLevel (GHL) Integration

Bruger du allerede GoHighLevel (GHL) til at administrere din virksomhed? Denne integration lader dig tilføje DM Champ's AI-drevne beskeder oven på din eksisterende GHL-opsætning. Beskeder, der kommer ind i GHL, videresendes til DM Champ til AI-drevet håndtering, og svar fra DM Champ sendes tilbage gennem GHL til kunden på den oprindelige kanal.

Bruger du et andet CRM? Det behøver ikke en dedikeret skærm for at fungere med DM Champ: se Tilslutning af et værktøj, vi ikke har på listen for brugerdefinerede funktioner, API’et og webhooks.

Det betyder, at du kan fortsætte med at bruge GHL som dit primære knudepunkt, mens du lader AI’en håndtere de AI-drevne samtaler.

Hvad denne opsætning ikke gør: Det er et tovejs-beskedrelæ, som du bygger med GHL-workflows og webhooks, ikke en forbindelse med ét klik. Det synkroniserer ikke leads eller kontakter fra GHL CRM (en kontakt oprettes her, når deres første besked videresendes), og du kan ikke sende udsendelser til GHL-lister eller smarte lister fra DM Champ.

Bemærk: Dette er en mere teknisk integration, der involverer opsætning af automatiserede arbejdsgange og forbindelse af systemer ved hjælp af webhooks (automatiske meddelelser mellem apps) og API-kald. Hvis du ikke er tryg ved dette, kan du med fordel give denne side til en udvikler eller et teknisk kyndigt teammedlem.


Forudsætninger

  • En aktiv DM Champ-konto med din API-nøgle (findes under Settings → Integrations → API Key). En API-nøgle er en unik kode, der lader GHL kommunikere sikkert med din konto.
  • En GoHighLevel-konto med tilladelse til at oprette workflows og administrere webhooks (automatiserede meddelelser mellem systemer).

Hvordan det fungerer

Retning Hvad sker der
GHL til DM Champ En kunde sender dig en besked via SMS, e-mail, Messenger, Instagram eller live chat i GHL. Et workflow videresender automatisk beskeden til DM Champ. DM Champ behandler den (AI-svar, tagging osv.).
DM Champ til GHL Når DM Champ sender et svar (manuelt eller via AI), giver det automatisk besked til GHL. Et workflow i GHL finder kontakten og sender svaret gennem den korrekte kanal.

Workflow 1: GHL til DM Champ

Dette workflow videresender indgående beskeder fra GHL til DM Champ.

Trin 1: Opret arbejdsgangen

  1. I GHL skal du klikke på Automation i sidepanelet og åbne fanen Workflows.
  2. Klik på Create workflow og derefter på Start from Scratch.
  3. Klik på blyanten ved siden af titlen og giv den et beskrivende navn, såsom “Send besked til DM Champ.”

Trin 2: Tilføj udløsere

GHL har én Customer replied-trigger. Du tilføjer den én gang pr. kanal og bruger dens Reply channel-filter til at vælge kanalen:

  1. Klik på Add new trigger, søg efter “Customer replied” og vælg den.
  2. Klik på Add filters, vælg Reply channel og vælg én kanal (filteret tager én kanal pr. trigger).
  3. Giv triggeren et tydeligt navn, for eksempel “Customer replied SMS”, og klik på Save trigger.
  4. Gentag for hver kanal, du ønsker at videresende.
Trigger-navn Svarskanal
Customer replied SMS SMS
Customer replied Email Email
Customer replied Facebook messenger Facebook messenger
Customer replied Instagram DM Instagram DM
Customer replied Live chat Live chat
Customer replied Chat widget Chat widget

Website-chat kan ankomme som enten Live chat eller Chat widget, så tilføj en trigger for begge, hvis du bruger GHL’s website-chat. Du kan tilføje alle disse eller kun de kanaler, der er relevante for din opsætning.

Trin 3: Tilføj tag-filter (valgfrit)

Hvis du kun ønsker at videresende beskeder fra specifikke kontakter:

  1. Klik på Add filters på hver trigger.
  2. Sæt betingelsen til “Contact has tag.”
  3. Vælg dit/dine tag(s).
  4. Vælg om kontakten skal have nogen eller alle af de valgte tags.

Trin 4: Opret en kanalopdeling

Tilføj en If / else-handling (vælg Build your own) for at dirigere hver kanal til dens egen webhook. Hver gren tjekker, hvilken trigger der startede workflowet: sæt feltet til Workflow trigger, operatoren til Is, og værdien til trigger-navnet fra Trin 2.

Gren Betingelse
Email Workflow trigger er Customer replied Email
SMS Workflow trigger er Customer replied SMS
Messenger Workflow trigger er Customer replied Facebook messenger
Instagram Workflow trigger er Customer replied Instagram DM
Live Chat Workflow trigger er Customer replied Live chat ELLER Customer replied Chat widget (to betingelser forbundet med ELLER)

GHL tilføjer automatisk en None-gren; lad den stå tom.

Trin 5: Konfigurer webhooks

For hver gren skal du tilføje en Webhook-handling (under Send data; du behøver ikke den premium Custom webhook):

  • Metode: POST

  • URL:

    https://api.dmchamp.com/v1/incoming_custom_channel_message?apiKey=YOUR_API_KEY
    
  • Custom Data fields (klik på Add item for hvert felt):

Felt Værdi Noter
messageSid {{right_now.second}}{{contact.id}} Unik besked-identifikator
fromId {{contact.id}} GHL kontakt-ID
toId {{user.id}} Dit GHL bruger-ID (det kan ankomme tomt, for eksempel i en live chat hvor ingen er tildelt; det er fint)
body {{message.body}} Beskedens indhold
channel Se tabel nedenfor Skal matche grenen

Tilføj kun disse felter. DM Champ afviser ethvert felt, det ikke genkender, så hele beskeden fejler, hvis webhooken indeholder et ekstra felt såsom messageType eller status (GHL’s eksekveringslog viser derefter Unknown field: ...). De eneste andre felter, den accepterer, er valgfrie: firstName, lastName og email for kontakten, samt mediaUrl med mediaContentType for en vedhæftet fil.

Tip: Hvis du skriver en værdi såsom {{contact.id}} i et værdifelt, bliver det til et flettefelt-chip. Du kan også vælge flettefelter med tag-ikonet for enden af feltet.

Kanalværdier pr. gren:

Gren channel værdi
E-mail email
SMS sms
Messenger messenger
Instagram ig
Live Chat livechat

Vigtigt: Sørg for, at channel-værdien matcher præcist. Disse værdier skelner mellem store og små bogstaver.

Andre GHL-kanaler (TikTok, WhatsApp osv.): de fem ovenstående er eksempler, ikke en fast liste. DM Champ sender præcis den channel-værdi tilbage, som den modtog, så relæet fungerer kun for en kanal, når GHL selv har både en “Kunde svarede”-trigger for den (en værdi i triggerens filter for svarkanal) og en workflow-handling, der sender på den. Hvor GHL har begge dele: tilføj en “Kunde svarede”-trigger for den og en forgrening her med din egen værdi (for eksempel tiktok), og derefter en matchende forgrening i Workflow 2, der bruger GHL’s sendehandling for den kanal. Værdien gemmes, når en kontakt første gang når DM Champ, så en kontakt, der først skrev på Instagram, bliver ved med at få svar tagget med ig, selvom de senere sender dig en besked på TikTok. En kanal, som GHL ikke kan trigge på eller sende igennem i et workflow, kan ikke videresendes.

Trin 6: Aktivér genindtræden

På workflowets Indstillinger-fane skal du sikre dig, at Tillad genindtræden er slået til. Nye GHL-workflows har det slået til som standard, men tjek det: uden det videresendes kun den første besked fra hver kontakt.

Skift derefter workflowet fra Kladde til Udgiv. Hvis du redigerer et udgivet workflow senere, skal du klikke på Gem øverst til højre, da automatisk lagring kun gælder for kladder.


Workflow 2: DM Champ til GHL

Dette workflow modtager svar fra DM Champ og sender dem til kunden gennem den korrekte GHL-kanal.

Trin 1: Opret workflowet og dets indgående webhook-trigger

I GHL er det indgående webhook en workflow-trigger, ikke en side under Indstillinger. Det er en premium-trigger, så GHL opkræver muligvis gebyr pr. kørsel afhængigt af dit abonnement.

  1. I GHL skal du klikke på Automatisering i sidepanelet, åbne Workflows, klikke på Opret workflow og derefter Start fra bunden.
  2. Navngiv workflowet “Send besked til kontakt.”
  3. Klik på Tilføj ny trigger, søg efter “webhook” og vælg Indgående webhook. Navngiv triggeren, for eksempel “Beskeder fra DM Champ.”
  4. Kopiér URL’en, der vises i feltet URL (POST/GET/PUT). Du skal bruge den i Trin 2.
  5. Triggeren gemmes ikke, før GHL har set en eksempelanmodning. Gennemfør Trin 2 først, klik derefter på Hent eksempelanmodninger (eller Tjek for nye anmodninger), vælg anmodningen under Mapping-reference og klik på Gem trigger.

URL’en ændres, hvis du vælger triggeren igen. GHL genererer en ny URL, hver gang Indgående webhook vælges igen. Hvis det sker, skal du kopiere den nye URL og indsætte den i kortet for den tilpassede kanal igen (Trin 2), ellers stopper svarene med at nå frem til GHL.

Trin 2: Konfigurer DM Champ

  1. I DM Champ skal du klikke på Indstillinger i sidepanelet.
  2. Under Kanaler skal du klikke på Kanaler.
  3. Rul ned til kortet Tilpasset kanal nederst på siden.
  4. Indsæt den GHL-webhook-URL, du lige har kopieret, i Webhook-URL (det skal være en offentlig HTTPS-adresse) og klik på Gem.
  5. Giv GHL sin eksempelanmodning: send eksempel-JSON’en vist nedenfor til GHL-URL’en én gang med et hvilket som helst HTTP-værktøj (for eksempel curl -X POST -H "Content-Type: application/json" -d '<the JSON>' <the GHL URL>). Hvis du allerede har en kontakt på den tilpassede kanal, virker det også at sende den kontakt en besked fra DM Champ. Gå derefter tilbage til triggeren og afslut Trin 1, punkt 5.

Dette er ikke siden Indstillinger → Integrationer → Webhooks. Den side er til hændelsesmeddelelser og sender en anden nyttelast. GHL-udgående relæet indstilles på kortet Brugerdefineret kanal under Indstillinger → Kanaler.

DM Champ vil nu automatisk sende en meddelelse til GHL, hver gang en besked sendes til en kontakt. De sendte data ser således ud:

{
  "contactId": "NtL97bwnhITrfIq8lWFi",
  "messageId": "s28dtg13qNuhXLoKpcLs",
  "userId": "wpDZRvaw4Hgh4whUBpwlKPRftOi2",
  "body": "Message content here",
  "toId": "qtpBsc6fiqkXTnSOeze3",
  "channel": "email"
}

Navigationsnote: Den API-nøgle, du bruger til Workflow 1, og det kort for tilpasset kanal, du bruger her, findes forskellige steder: Indstillinger → Integrationer → API-nøgle for nøglen, og kortet Tilpasset kanal nederst i Indstillinger → Kanaler for dette relæ. Den separate side Indstillinger → Integrationer → Webhooks er til hændelsesmeddelelser og sender en anden payload; se Webhooks, hvis det er det, du ønsker i stedet.

Trin 3: Tjek at triggeren blev gemt

Tilbage i workflowet “Send besked til kontakt” skal du bekræfte, at Indgående webhook-triggeren nu viser en mapping-reference og er gemt. De felter, som DM Champ sender (body, toId, channel og resten), er nu tilgængelige som flettefelter under Indgående webhook-trigger.

Trin 4: Tilføj en Find kontakt-handling

  1. Tilføj en Find kontakt-handling (i kategorien Kontakt, ikke en app-handling med samme navn længere nede på listen).
  2. Klik på Tilføj felt, vælg Kontakt-ID.
  3. Brug værdien: {{inboundWebhookRequest.toId}}. Dette er det GHL-kontakt-ID, som Workflow 1 sendte som fromId, så det matcher kontakten i GHL.

Find kontakt tilføjer to forgreninger, Kontakt fundet og Kontakt ikke fundet. Byg de næste trin under Kontakt fundet.

Trin 5: Tilføj en valgfri tjek af tags

Hvis du vil begrænse, hvilke kontakter der modtager beskeder fra DM Champ:

  1. Tilføj en Hvis / ellers-handling.
  2. Tjek om kontakten har et specifikt tag.
  3. Hvis tagget mangler, afslut workflowet (tilføj en “Stop”-handling på den falske forgrening).

Trin 6: Tilføj en kanalopdeling

Tilføj en Hvis / ellers-handling, der dirigerer beskeden baseret på kanal-feltet (kategorien Indgående webhook-trigger) med operatoren Er:

Gren Betingelse Handling
E-mail kanal er email Send e-mail (den kræver også et emne)
SMS kanal er sms Send SMS
Messenger kanal er messenger Messenger
Instagram kanal er ig Instagram DM
Live Chat kanal er livechat Send live chat-besked

Messenger og Instagram kræver en forbundet konto i GHL. GHL vil ikke publicere et workflow, der indeholder Messenger- eller Instagram DM-handlingen, medmindre en Facebook-side eller Instagram-konto er forbundet til den pågældende GHL-underkonto. Hvis du ikke bruger disse kanaler, skal du udelade disse grene.

Trin 7: Konfigurer hver send-handling

I hver send-handling skal du indstille beskedteksten til:

{{inboundWebhookRequest.body}}

Trin 8: Aktivér genindtræden

Som med Workflow 1 skal du sikre dig, at Tillad genindtræden (Allow re-entry) er slået til under workflowets faneblad Indstillinger (Settings), og derefter publicere workflowet.


Test af integrationen

Test GHL til DM Champ (Workflow 1)

  1. Send en besked til dit GHL-nummer eller en forbundet kanal (send for eksempel en SMS til dig selv).
  2. Åbn DM Champ og bekræft, at beskeden vises under Chats.
  3. Kontroller, at kanaletiketten er korrekt (SMS, e-mail osv.).
  4. Gentag for hver kanal, du har konfigureret.

Test DM Champ til GHL (Workflow 2)

  1. I DM Champ, send et svar til en kontaktperson (manuelt eller lad AI’en svare).
  2. Åbn GHL og bekræft, at kontaktpersonen har modtaget beskeden.
  3. Bekræft, at den blev sendt gennem den korrekte kanal.
  4. Tjek, at beskedindholdet stemmer overens.

Fejlfinding

Problem Hvad skal tjekkes
Beskeder når ikke frem til DM Champ Åbn workflowets Udførelseslogfiler (Execution logs) i GHL. Unknown field: ... betyder, at webhooken indeholder et felt, som DM Champ ikke accepterer: fjern det (kun felterne i Workflow 1, trin 5 er nødvendige). Bekræft ellers, at din API-nøgle er korrekt i webhook-URL’en, at triggere aktiveres, og at Tillad genindtræden er slået til.
Beskeder når ikke frem til GHL Bekræft, at GHL’s indgående webhook-URL er indsat korrekt i Webhook URL på kortet Brugerdefineret kanal (Custom channel) nederst under Indstillinger → Kanaler (Settings → Channels) (ikke på siden Indstillinger → Integrationer → Webhooks, hvilket er en anden funktion). Hvis du har valgt triggeren for indgående webhook igen, er dens URL ændret: indsæt den nye i kortet. Gennemgå GHL-workflowets udførelseslogfiler.
Kontakt ikke fundet i GHL toId i webhook-dataene skal matche et eksisterende GHL-kontakt-id. Sørg for, at kontakter findes i begge systemer med matchende id’er.
Forkert kanal brugt til svar Dobbelttjek kanalværdierne i dine betingelsesgrene. De skal matche præcis: email, sms, messenger, ig, livechat.
Kun første besked videresendes Slå Tillad genindtræden til i begge workflows’ indstillinger.
Workflow 2 kan ikke publiceres Fjern Messenger- eller Instagram DM-handlingen, eller forbind den Facebook- eller Instagram-konto i GHL først.
Trigger for indgående webhook kan ikke gemmes GHL har brug for en prøveanmodning som reference til mapping. Send én besked (eller en prøve-JSON) til URL’en, hent den, vælg den, og gem derefter.

Næste skridt