# GoHighLevel (GHL)-integrering

Använder du redan GoHighLevel (GHL) för att hantera din verksamhet? Denna integration låter dig lägga till <span data-t="appName">Your AI Connector</span>s AI-drivna meddelandehantering ovanpå din befintliga GHL-konfiguration. Meddelanden som kommer in till GHL vidarebefordras till <span data-t="appName">Your AI Connector</span> för AI-styrd hantering, och svar från <span data-t="appName">Your AI Connector</span> skickas tillbaka genom GHL till kunden via den ursprungliga kanalen.

> Använder du ett annat CRM? Det behöver inte en dedikerad skärm för att fungera med <span data-t="appName">Your AI Connector</span>: se [Ansluta ett verktyg vi inte listar](connecting-other-tools.md) för anpassade funktioner, API:et och webhooks.

Detta innebär att du kan fortsätta använda GHL som din huvudhubb samtidigt som du låter AI:n sköta de AI-drivna konversationerna.

::: note
**Obs:** Detta är en mer teknisk integration som innebär att man ställer in automatiserade arbetsflöden och kopplar samman system med hjälp av webhooks (automatiska aviseringar mellan appar) och API-anrop. Om du inte känner dig bekväm med detta kan du vilja överlämna denna sida till en utvecklare eller en tekniskt kunnig teammedlem.
:::


---

## Förutsättningar

- Ett aktivt **<span data-t="appName">Your AI Connector</span>-konto** med din API-nyckel (finns under **Settings → Integrations → API Key**). En API-nyckel är en unik kod som gör att GHL säkert kan kommunicera med ditt konto.
- Ett **GoHighLevel-konto** med behörighet att skapa arbetsflöden och hantera webhooks (automatiserade aviseringar mellan system).

---

## Hur det fungerar

| Riktning | Vad som händer |
|---|---|
| **GHL till <span data-t="appName">Your AI Connector</span>** | En kund skickar ett meddelande till dig via SMS, e-post, Messenger, Instagram eller livechatt i GHL. Ett arbetsflöde vidarebefordrar automatiskt meddelandet till <span data-t="appName">Your AI Connector</span>. <span data-t="appName">Your AI Connector</span> bearbetar det (AI-svar, taggning, etc.). |
| **<span data-t="appName">Your AI Connector</span> till GHL** | När <span data-t="appName">Your AI Connector</span> skickar ett svar (manuellt eller via AI) meddelas GHL automatiskt. Ett arbetsflöde i GHL hittar kontakten och skickar svaret via rätt kanal. |

---

## Arbetsflöde 1: GHL till <span data-t="appName">Your AI Connector</span>

Detta arbetsflöde vidarebefordrar inkommande meddelanden från GHL till <span data-t="appName">Your AI Connector</span>.

### Steg 1: Skapa arbetsflödet

1. I GHL, gå till **Automation > Workflows**.
2. Klicka på **Create New Workflow**.
3. Ge det ett beskrivande namn, till exempel "Skicka meddelande till <span data-t="appName">Your AI Connector</span>."

### Steg 2: Lägg till utlösare

Lägg till en utlösare för varje kanal du vill vidarebefordra:

- Kund svarade - SMS
- Kund svarade - E-post
- Kund svarade - Facebook-meddelande
- Kund svarade - Instagram DM
- Kund svarade - Livechatt

Du kan lägga till alla eller bara de kanaler som är relevanta för din konfiguration.

### Steg 3: Lägg till taggfilter (valfritt)

Om du bara vill vidarebefordra meddelanden från specifika kontakter:

1. Klicka på **Lägg till filter** på utlösaren.
2. Ställ in villkoret till "Kontakt har tagg."
3. Välj din/dina tagg(ar).
4. Välj om kontakten ska ha **någon** eller **alla** av de valda taggarna.

### Steg 4: Skapa en kanaldelning

Lägg till en **Villkor**-åtgärd för att dirigera varje kanal till sin egen webhook:

| Gren | Villkor |
|---|---|
| Gren 1 | Meddelandekälla är lika med `Email` |
| Gren 2 | Meddelandekälla är lika med `SMS` |
| Gren 3 | Meddelandekälla är lika med `Messenger` |
| Gren 4 | Meddelandekälla är lika med `Instagram` |
| Gren 5 | Meddelandekälla är lika med `Live Chat` |

### Steg 5: Konfigurera webhooks

För varje gren, lägg till en **Webhook / HTTP-förfrågan**-åtgärd:

- **Metod:** `POST`
- **URL:**
  ```
  https://api.youraiconnector.com/v1/incoming_custom_channel_message?apiKey=YOUR_API_KEY
  ```

- **Anpassade datafält:**

| Fält | Värde | Anteckningar |
|---|---|---|
| `messageSid` | `{{right_now.second}}{{contact.id}}` | Unik meddelandeidentifierare |
| `fromId` | `{{contact.id}}` | GHL-kontakt-ID |
| `toId` | `{{user.id}}` | Ditt GHL-användar-ID |
| `body` | `{{message.body}}` | Meddelandeinnehållet |
| `channel` | Se tabell nedan | Måste matcha grenen |
| `status` | `created` | Sätts alltid till `created` |
| `messageType` | `text` | Meddelandetyp |

**Kanalvärden per gren:**

| Gren | `channel` värde |
|---|---|
| E-post | `email` |
| SMS | `sms` |
| Messenger | `messenger` |
| Instagram | `ig` |
| Livechatt | `livechat` |

::: warning
**Viktigt:** Se till att värdet `channel` stämmer exakt — dessa är skiftlägeskänsliga.
:::


### Steg 6: Aktivera återinträde

I arbetsflödesinställningarna, se till att **Tillåt återinträde** är aktiverat. Utan detta kommer endast det första meddelandet från varje kontakt att vidarebefordras.

---

## Arbetsflöde 2: Your AI Connector till GHL

Detta arbetsflöde tar emot svar från Your AI Connector och skickar dem till kunden via rätt GHL-kanal.

### Steg 1: Skapa en inkommande webhook i GHL

1. I GHL, gå till **Settings > Developers / API**.
2. Klicka på **Create New Webhook** (eller "Inbound Webhook").
3. Ge den namnet "Messages."
4. Spara och **kopiera webhook-URL:en** — du kommer att behöva den i nästa steg.

### Steg 2: Konfigurera Your AI Connector

1. I Your AI Connector, klicka på **Settings** i sidofältet.
2. Under **Channels**, klicka på **Channels**.
3. Skrolla till kortet **Custom channel** längst ner på sidan.
4. Klistra in den GHL-inkommande webhook-URL som du precis kopierade i **Webhook URL** (det måste vara en offentlig HTTPS-adress) och klicka på **Save**.

> **Detta är inte sidan Settings → Integrations → Webhooks.** Den sidan är till för händelseaviseringar och skickar en annan nyttolast. GHL-utgående relä ställs in på kortet **Custom channel** under **Settings → Channels**.

Your AI Connector kommer nu automatiskt att skicka en avisering till GHL varje gång ett meddelande skickas till en kontakt. Datan som skickas ser ut så här:

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

> **Navigeringsnotering:** API-nyckeln du använder för Workflow 1 och kortet Custom channel som du använder här finns på olika platser — **Settings → Integrations → API Key** för nyckeln, och kortet **Custom channel** längst ner på **Settings → Channels** för detta relä. Den separata sidan **Settings → Integrations → Webhooks** är till för händelseaviseringar och skickar en annan nyttolast; se [Webhooks](webhooks.md) om det är vad du vill ha istället.

### Steg 3: Skapa svarsarbetsflödet

1. I GHL, gå till **Automation > Workflows**.
2. Skapa ett nytt arbetsflöde med namnet "Send Message to Contact."
3. Ställ in utlösaren (trigger) till **Inbound Webhook** och välj den webhook du skapade i steg 1.

### Steg 4: Lägg till en åtgärd för att hitta kontakt

1. Lägg till en **Find Contact**-åtgärd.
2. Ställ in sökfältet till **Contact ID**.
3. Använd värdet: `{{inboundWebhookRequest.toId}}`

### Steg 5: Lägg till en valfri taggkontroll

Om du vill begränsa vilka kontakter som får meddelanden från Your AI Connector:

1. Lägg till en **Condition**-åtgärd.
2. Kontrollera om kontakten har en specifik tagg.
3. Om taggen saknas, avsluta arbetsflödet (lägg till en "Stop"-åtgärd på den falska grenen).

### Steg 6: Lägg till en kanaluppdelning

Lägg till en **Villkor**-åtgärd som dirigerar meddelandet baserat på `{{inboundWebhookRequest.channel}}`:

| Gren | Villkor | Åtgärd |
|---|---|---|
| Gren 1 | lika med `email` | Skicka e-post |
| Gren 2 | lika med `sms` | Skicka SMS |
| Gren 3 | lika med `messenger` | Skicka Facebook-meddelande |
| Gren 4 | lika med `ig` | Skicka Instagram-meddelande |
| Gren 5 | lika med `livechat` | Skicka chattmeddelande |

### Steg 7: Konfigurera varje skicka-åtgärd

I varje skicka-åtgärd, ställ in meddelandetexten till:

```
{{inboundWebhookRequest.body}}
```

### Steg 8: Aktivera återinträde

Precis som med Arbetsflöde 1, se till att **Tillåt återinträde** är aktiverat i arbetsflödesinställningarna.

---

## Testa integrationen

### Testa GHL till <span data-t="appName">Your AI Connector</span> (Arbetsflöde 1)

1. Skicka ett meddelande till ditt GHL-nummer eller anslutna kanal (skicka till exempel ett SMS till dig själv).
2. Öppna <span data-t="appName">Your AI Connector</span> och kontrollera att meddelandet visas under **Chats**.
3. Kontrollera att kanaletiketten är korrekt (SMS, e-post, etc.).
4. Upprepa för varje kanal du har konfigurerat.

### Testa <span data-t="appName">Your AI Connector</span> till GHL (Arbetsflöde 2)

1. I <span data-t="appName">Your AI Connector</span>, skicka ett svar till en kontakt (manuellt eller låt AI:n svara).
2. Öppna GHL och verifiera att kontakten tog emot meddelandet.
3. Bekräfta att det skickades via rätt kanal.
4. Kontrollera att meddelandeinnehållet stämmer.

---

## Felsökning

| Problem | Vad du ska kontrollera |
|---|---|
| Meddelanden når inte <span data-t="appName">Your AI Connector</span> | Kontrollera att din API-nyckel är korrekt i webhook-URL:en. Kontrollera att arbetsflödesutlösarna aktiveras (GHL-arbetsflödesloggar). Bekräfta att Allow Re-entry är aktiverat. |
| Meddelanden når inte GHL | Kontrollera att den GHL-inkommande webhook-URL:en är korrekt inklistrad i **Webhook URL** på kortet **Custom channel** längst ner på **Settings → Channels** (inte på sidan Settings → Integrations → Webhooks, vilket är en annan funktion). Kontrollera att den GHL-inkommande webhooken är aktiv. Granska GHL-arbetsflödets körningsloggar. |
| Kontakt hittades inte i GHL | `toId` i webhook-datan måste matcha ett befintligt GHL-kontakt-ID. Se till att kontakter finns i båda systemen med matchande ID:n. |
| Fel kanal används för svar | Dubbelkolla kanalvärdena i dina villkorsgrenar. De måste matcha exakt: `email`, `sms`, `messenger`, `ig`, `livechat`. |
| Endast första meddelandet vidarebefordras | Aktivera **Allow Re-entry** i båda arbetsflödesinställningarna. |

---

## Nästa steg

- [Webhooks](webhooks.md) — ställ in webhooks för andra <span data-t="appName">Your AI Connector</span>-händelser.
- [API-åtkomst](api-access.md) — använd API:et för anpassade integrationer utöver GHL.
- [Anpassade kanaler](../messaging-channels/custom-channels.md) — lär dig mer om meddelanden via anpassade kanaler.