GoHighLevel (GHL) -integraatio #

Käytätkö jo GoHighLevelia (GHL) liiketoimintasi hallintaan? Tämän integraation avulla voit lisätä Your AI Connector:n tekoälypohjaisen viestinnän olemassa olevan GHL-asetuksesi päälle. GHL:ään tulevat viestit välitetään Your AI Connector:lle tekoälypohjaista käsittelyä varten, ja Your AI Connector:n vastaukset lähetetään takaisin GHL:n kautta asiakkaalle alkuperäistä kanavaa pitkin.

Käytätkö toista CRM-järjestelmää? Se ei tarvitse erillistä näyttöä toimiakseen Your AI Connector:n kanssa: katso Sellaisen työkalun yhdistäminen, jota emme listaa mukautettuja toimintoja, API-rajapintaa ja webhookeja varten.

Tämä tarkoittaa, että voit jatkaa GHL:n käyttöä pääasiallisena keskuksena ja antaa tekoälyn hoitaa tekoälyohjatut keskustelut.

Esivaatimukset #

• Aktiivinen Your AI Connector-tili ja API-avain (löytyy kohdasta Settings → Integrations → API Key). API-avain on yksilöllinen koodi, jonka avulla GHL voi kommunikoida tilisi kanssa turvallisesti.
• GoHighLevel-tili, jolla on oikeudet luoda työnkulkuja (workflows) ja hallita webhookeja (järjestelmien välisiä automaattisia ilmoituksia).

Miten se toimii #

Työnkulku 1: GHL -> Your AI Connector #

Tämä työnkulku välittää saapuvat viestit GHL:stä Your AI Connector:lle.

Vaihe 1: Luo työnkulku #

1. Siirry GHL:ssä kohtaan Automation > Workflows.
2. Napsauta Create New Workflow.
3. Anna sille kuvaava nimi, kuten “Send Message to Your AI Connector.”

Vaihe 2: Lisää käynnistimet #

Lisää käynnistin jokaiselle kanavalle, jonka haluat välittää:

• Asiakas vastasi - tekstiviesti
• Asiakas vastasi - sähköposti
• Asiakas vastasi - Facebook-viesti
• Asiakas vastasi - Instagram DM
• Asiakas vastasi - live-chat

Voit lisätä ne kaikki tai vain asetuksillesi olennaiset kanavat.

Vaihe 3: Lisää tägisuodatin (valinnainen) #

Jos haluat välittää viestejä vain tietyiltä yhteyshenkilöiltä:

1. Napsauta Lisää suodatin (Add Filter) käynnistimessä.
2. Aseta ehdoksi “Yhteyshenkilöllä on tunniste” (Contact has tag).
3. Valitse tunniste(et).
4. Valitse, pitääkö yhteyshenkilöllä olla mikä tahansa vai kaikki valituista tunnisteista.

Vaihe 4: Luo kanavajako (Channel Split) #

Lisää Ehto-toiminto (Condition), jotta kukin kanava ohjataan omaan webhookiinsa:

Vaihe 5: Määritä webhookit #

Lisää jokaiselle haaralle Webhook / HTTP-pyyntö -toiminto:

• Menetelmä: POST

• URL:

  https://api.youraiconnector.com/v1/incoming_custom_channel_message?apiKey=YOUR_API_KEY
  

• Mukautetut tietokentät:

Kanava-arvot haaroittain:

Vaihe 6: Ota uudelleenosallistuminen käyttöön #

Varmista työnkulun asetuksista, että Salli uudelleenosallistuminen (Allow Re-entry) on käytössä. Ilman tätä vain kunkin yhteyshenkilön ensimmäinen viesti välitetään.

Työnkulku 2: Your AI Connector -> GHL #

Tämä työnkulku vastaanottaa vastaukset Your AI Connector:lta ja lähettää ne asiakkaalle oikean GHL-kanavan kautta.

Vaihe 1: Luo saapuva webhook GHL:ssä #

1. Siirry GHL:ssä kohtaan Settings > Developers / API.
2. Napsauta Create New Webhook (tai “Inbound Webhook”).
3. Anna sille nimeksi “Messages.”
4. Tallenna ja kopioi webhook-URL – tarvitset sitä seuraavassa vaiheessa.

Vaihe 2: Määritä Your AI Connector #

1. Napsauta kohdassa Your AI Connector sivupalkin kohtaa Settings.
2. Napsauta kohdassa Channels kohtaa Channels.
3. Vieritä sivun alareunaan Custom channel -korttiin.
4. Liitä juuri kopioimasi GHL:n saapuvan verkkokoukun (webhook) URL-osoite kohtaan Webhook URL (sen on oltava julkinen HTTPS-osoite) ja napsauta Save.

Tämä ei ole Settings → Integrations → Webhooks -sivu. Kyseinen sivu on tarkoitettu tapahtumailmoituksille ja se lähettää erilaisen hyötykuorman. GHL:n lähtevä välitys määritetään Custom channel -kortissa kohdassa Settings → Channels.

Your AI Connector lähettää nyt automaattisesti ilmoituksen GHL:lle aina, kun viesti lähetetään yhteyshenkilölle. Lähetetty tieto näyttää tältä:

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

Huomautus navigoinnista: Työnkulussa 1 käyttämäsi API-avain ja tässä käytettävä Custom channel -kortti sijaitsevat eri paikoissa — API-avain löytyy kohdasta Settings → Integrations → API Key ja tämä välitys kohdasta Settings → Channels sivun alareunassa olevasta Custom channel -kortista. Erillinen Settings → Integrations → Webhooks -sivu on tarkoitettu tapahtumailmoituksille ja se lähettää erilaisen hyötykuorman; katso Webhooks, jos etsit sitä.

Vaihe 3: Luo vastaustyönkulku #

1. Siirry GHL:ssä kohtaan Automation > Workflows.
2. Luo uusi työnkulku nimeltä “Send Message to Contact.”
3. Aseta käynnistimeksi Inbound Webhook ja valitse vaiheessa 1 luomasi webhook.

Vaihe 4: Lisää yhteyshenkilön etsimistoiminto #

1. Lisää Find Contact -toiminto.
2. Aseta hakukentäksi Contact ID.
3. Käytä arvoa: {{inboundWebhookRequest.toId}}

Vaihe 5: Lisää valinnainen tunnisteen tarkistus #

Jos haluat rajoittaa, mitkä yhteyshenkilöt saavat viestejä Your AI Connector:lta:

1. Lisää Condition-toiminto.
2. Tarkista, onko yhteyshenkilöllä tietty tunniste.
3. Jos tunniste puuttuu, lopeta työnkulku (lisää “Stop”-toiminto epätosi-haaraan).

Vaihe 6: Lisää kanavajako #

Lisää Condition-toiminto, joka reitittää viestin kohteen {{inboundWebhookRequest.channel}} perusteella:

Vaihe 7: Määritä jokainen lähetystoiminto #

Aseta jokaisessa lähetystoiminnossa viestin rungoksi:

{{inboundWebhookRequest.body}}

Vaihe 8: Ota uudelleensyöttö käyttöön #

Kuten työnkulussa 1, varmista, että Allow Re-entry on käytössä työnkulun asetuksissa.

Integraation testaaminen #

Testaa GHL -> Your AI Connector (Työnkulku 1) #

1. Lähetä viesti GHL-numeroosi tai yhdistettyyn kanavaan (lähetä esimerkiksi itsellesi tekstiviesti).
2. Avaa Your AI Connector ja varmista, että viesti näkyy kohdassa Chats.
3. Tarkista, että kanavan tunniste on oikein (SMS, sähköposti jne.).
4. Toista jokaiselle määrittämällesi kanavalle.

Testaa Your AI Connector -> GHL (Työnkulku 2) #

1. Lähetä Your AI Connector-palvelussa vastaus yhteyshenkilölle (manuaalisesti tai anna tekoälyn vastata).
2. Avaa GHL ja varmista, että yhteyshenkilö sai viestin.
3. Vahvista, että se lähetettiin oikean kanavan kautta.
4. Tarkista, että viestin sisältö täsmää.

Vianmääritys #

Seuraavat vaiheet #

• Webhookit — määritä webhookit muille Your AI Connector-tapahtumille.
• API-käyttöoikeus — käytä API-rajapintaa mukautettuihin integraatioihin GHL:n ulkopuolella.
• Mukautetut kanavat — lue lisää mukautettujen kanavien viestinnästä.