# GoHighLevel (GHL) -integraatio

Käytätkö jo GoHighLevelia (GHL) liiketoimintasi hallintaan? Tämän integraation avulla voit lisätä <span data-t="appName">Your AI Connector</span>:n tekoälypohjaisen viestinnän olemassa olevan GHL-asetuksesi päälle. GHL:ään tulevat viestit välitetään <span data-t="appName">Your AI Connector</span>:lle tekoälypohjaista käsittelyä varten, ja <span data-t="appName">Your AI Connector</span>: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 <span data-t="appName">Your AI Connector</span>:n kanssa: katso [Sellaisen työkalun yhdistäminen, jota emme listaa](connecting-other-tools.md) 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.

::: note
**Huomautus:** Tämä on teknisempi integraatio, joka edellyttää automatisoitujen työnkulkujen määrittämistä ja järjestelmien yhdistämistä webhookien (sovellusten väliset automaattiset ilmoitukset) ja API-kutsujen avulla. Jos tämä ei tunnu luontevalta, voit antaa tämän sivun kehittäjälle tai teknisesti taitavalle tiimin jäsenelle.
:::


---

## Esivaatimukset

- Aktiivinen **<span data-t="appName">Your AI Connector</span>-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

| Suunta | Mitä tapahtuu |
|---|---|
| **GHL -> <span data-t="appName">Your AI Connector</span>** | Asiakas lähettää sinulle viestin tekstiviestillä, sähköpostilla, Messengerillä, Instagramilla tai live-chatilla GHL:ssä. Työnkulku välittää viestin automaattisesti <span data-t="appName">Your AI Connector</span>:lle. <span data-t="appName">Your AI Connector</span> käsittelee sen (tekoälyvastaus, tägäys jne.). |
| **<span data-t="appName">Your AI Connector</span> -> GHL** | Kun <span data-t="appName">Your AI Connector</span> lähettää vastauksen (manuaalisesti tai tekoälyllä), se ilmoittaa siitä automaattisesti GHL:lle. GHL:n työnkulku etsii yhteystiedon ja lähettää vastauksen oikean kanavan kautta. |

---

## Työnkulku 1: GHL -> <span data-t="appName">Your AI Connector</span>

Tämä työnkulku välittää saapuvat viestit GHL:stä <span data-t="appName">Your AI Connector</span>: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 <span data-t="appName">Your AI Connector</span>."

### 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:

| Haara | Ehto |
|---|---|
| Haara 1 | Viestin lähde on `Email` |
| Haara 2 | Viestin lähde on `SMS` |
| Haara 3 | Viestin lähde on `Messenger` |
| Haara 4 | Viestin lähde on `Instagram` |
| Haara 5 | Viestin lähde on `Live Chat` |

### 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:**

| Kenttä | Arvo | Huomautukset |
|---|---|---|
| `messageSid` | `{{right_now.second}}{{contact.id}}` | Yksilöllinen viestitunniste |
| `fromId` | `{{contact.id}}` | GHL-yhteyshenkilön tunnus |
| `toId` | `{{user.id}}` | GHL-käyttäjätunnuksesi |
| `body` | `{{message.body}}` | Viestin sisältö |
| `channel` | Katso alla oleva taulukko | On vastattava haaraa |
| `status` | `created` | Aseta aina arvoon `created` |
| `messageType` | `text` | Viestityyppi |

**Kanava-arvot haaroittain:**

| Haara | `channel` arvo |
|---|---|
| Sähköposti | `email` |
| SMS | `sms` |
| Messenger | `messenger` |
| Instagram | `ig` |
| Live-chat | `livechat` |

::: warning
**Tärkeää:** Varmista, että `channel`-arvo täsmää täydellisesti – näissä on kirjainkoko ratkaiseva.
:::


### 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ä:

```json
{
  "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](webhooks.md), 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:

| Haara | Ehto | Toiminto |
|---|---|---|
| Haara 1 | on yhtä suuri kuin `email` | Lähetä sähköposti |
| Haara 2 | on yhtä suuri kuin `sms` | Lähetä tekstiviesti |
| Haara 3 | on yhtä suuri kuin `messenger` | Lähetä Facebook-viesti |
| Haara 4 | on yhtä suuri kuin `ig` | Lähetä Instagram-viesti |
| Haara 5 | on yhtä suuri kuin `livechat` | Lähetä chat-viesti |

### 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 -> <span data-t="appName">Your AI Connector</span> (Työnkulku 1)

1. Lähetä viesti GHL-numeroosi tai yhdistettyyn kanavaan (lähetä esimerkiksi itsellesi tekstiviesti).
2. Avaa <span data-t="appName">Your AI Connector</span> 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 <span data-t="appName">Your AI Connector</span> -> GHL (Työnkulku 2)

1. Lähetä <span data-t="appName">Your AI Connector</span>-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

| Ongelma | Mitä tarkistaa |
|---|---|
| Viestit eivät saavuta kohdetta <span data-t="appName">Your AI Connector</span> | Varmista, että API-avaimesi on oikein verkkokoukun URL-osoitteessa. Tarkista, että työnkulun käynnistimet aktivoituvat (GHL-työnkulun lokit). Vahvista, että Allow Re-entry on käytössä. |
| Viestit eivät saavuta GHL:ää | Varmista, että GHL:n saapuvan verkkokoukun URL-osoite on liitetty oikein kohtaan **Webhook URL** sivun alareunassa olevassa **Custom channel** -kortissa kohdassa **Settings → Channels** (ei Settings → Integrations → Webhooks -sivulla, joka on eri toiminto). Tarkista, että GHL:n saapuva verkkokoukku on aktiivinen. Tarkista GHL-työnkulun suorituslokit. |
| Yhteystietoa ei löydy GHL:stä | Verkkokoukun tiedoissa olevan `toId` on vastattava olemassa olevaa GHL-yhteystiedon tunnusta. Varmista, että yhteystiedot ovat olemassa molemmissa järjestelmissä vastaavilla tunnuksilla. |
| Vastaukseen käytetty väärää kanavaa | Tarkista kanava-arvot ehtohaaroistasi. Niiden on täsmättävä täydellisesti: `email`, `sms`, `messenger`, `ig`, `livechat`. |
| Vain ensimmäinen viesti välitetään | Ota **Allow Re-entry** käyttöön molemmissa työnkulun asetuksissa. |

---

## Seuraavat vaiheet

- [Webhookit](webhooks.md) — määritä webhookit muille <span data-t="appName">Your AI Connector</span>-tapahtumille.
- [API-käyttöoikeus](api-access.md) — käytä API-rajapintaa mukautettuihin integraatioihin GHL:n ulkopuolella.
- [Mukautetut kanavat](../messaging-channels/custom-channels.md) — lue lisää mukautettujen kanavien viestinnästä.