API-adgang #

En API (Application Programming Interface) er en måde for forskellige softwaresystemer at tale sammen på. Your AI Connector API’en lader dig (eller din udvikler) automatisk oprette kontakter, sende beskeder, administrere lister og modtage indgående beskeder fra brugerdefinerede kanaler — alt sammen uden at bruge kontrolpanelet.

Hvorfor bruge API’en? Hvis du vil forbinde appen til et værktøj, der ikke har en indbygget integration, eller hvis du har brug for at automatisere gentagne opgaver i stor skala, er API’en vejen frem.

Generering af din API-nøgle #

1. Klik på Indstillinger (tandhjulsikonet) i venstre sidepanel.
2. I sidepanelet Indstillinger, under gruppen Integrationer, skal du klikke på API-nøgle.

3. Hvis du endnu ikke har en nøgle, skal du klikke på Generer API-nøgle.
4. Hvis du allerede har en, vises den maskeret under Din nøgle. Hvis din nøgle understøtter det, skal du klikke på Vis for at afsløre den, og derefter Kopiér for at kopiere den — du vil se en bekræftelsesmeddelelse.
5. Gem nøglen et sikkert sted — du får brug for den til hver API-anmodning.

Teammedlemmer: API-nøglen tilhører kontoejeren, så hvis du er logget ind som et inviteret teammedlem (inklusive en administrator), viser sektionen en note i stedet for nøglen. Log ind som kontoejer for at se, kopiere eller gendanne den — dette gælder også for scoped-nøgler.

Hvor finder du den: API-nøgle er sin egen sektion under Indstillinger → Integrationer, adskilt fra Webhooks. Hvis en vejledning eller en kollega beder dig om at kigge under “Webhooks” efter nøglen, skal du i stedet kigge i sektionen ved siden af.

Scoped keys: ekstra nøgler til en specifik opgave #

Din hovednøgle kan alt, så det er ikke den nøgle, du skal give til en rapport, et klient-dashboard eller et separat sandbox- og udviklingsmiljø. Til det formål skal du oprette scoped keys (begrænsede nøgler) i kortet Scoped keys, i samme API Key-sektion under Your key:

1. Klik på New key.
2. Giv den et Name, som du kan genkende senere, for eksempel “Sandbox” eller “Acme klient-dashboard”.
3. Under What it can see skal du kun markere de områder, den har brug for.
4. Under What it can do skal du lade Read only være valgt, medmindre værktøjet skal kunne foretage ændringer. En nøgle, der kan foretage ændringer, kan sende beskeder og redigere i din opsætning.
5. Du kan eventuelt indstille Requests per minute (dens egen grænse, så den aldrig gør dine andre integrationer langsommere) og en Expires on-dato.
6. Klik på Create key og kopiér den med det samme. Scoped keys vises kun én gang; hvis du mister en, skal du tilbagekalde den og oprette en ny.

Du kan oprette lige så mange, som du har brug for. Hver nøgle på listen viser, hvornår den sidst blev brugt, og Revoke key stopper den med at fungere med det samme. Oprettelse eller tilbagekaldelse af en scoped key påvirker aldrig din hovednøgle. De fulde muligheder, herunder nøgler begrænset til specifikke underkonti, findes på siden API keys i API-referencen.

Basis-URL #

Alle API-anmodninger bruger følgende webadresse som basis:

https://api.youraiconnector.com/v1/

Godkendelse #

Hver anmodning skal indeholde din API-nøgle, så platformen ved, at det er dig. Den enkleste måde er at tilføje den til slutningen af webadressen:

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

Du kan også sende nøglen som et anmodningshoved i stedet for i URL’en (anbefales til produktion, så nøglen ikke ender i serverlogfiler):

X-API-Key: YOUR_API_KEY

Authorization: Bearer YOUR_API_KEY

Alle anmodninger skal bruge en sikker forbindelse (HTTPS). Usikre (HTTP) anmodninger afvises.

Leder du efter de fulde udviklervejledninger? Denne side er en hurtig introduktion, der dækker de mest almindelige handlinger. For komplette, trinvise vejledninger — alle ressourcer, med cURL-, JavaScript- og Python-eksempler — se Kom godt i gang med API’en og API-referencen.

Almindelige API-handlinger #

Opret en kontakt #

Anmodning:

POST https://api.youraiconnector.com/v1/contacts?apiKey=YOUR_API_KEY
Content-Type: application/json

{
  "firstName": "Jane",
  "lastName": "Smith",
  "phoneNumber": "+15551234567",
  "email": "jane@example.com"
}

Påkrævede felter: et phoneNumber (med landekode) er altid påkrævet for at oprette en kontakt. En e-mailadresse alene er ikke nok — en anmodning uden et gyldigt telefonnummer afvises. E-mailen er valgfri.

Svar:

{
  "success": true,
  "data": {
    "message": "Successfully created new contact",
    "contactId": "abc123xyz",
    "listsAdded": []
  }
}

Gem data.contactId — du skal bruge det til “Tilføj en kontakt til en liste”-kaldet.

Tilføj en kontakt til en liste #

POST https://api.youraiconnector.com/v1/contacts/lists?apiKey=YOUR_API_KEY
Content-Type: application/json

{
  "contactId": "abc123xyz",
  "listId": "YOUR_LIST_ID"
}

Find en listes ID i appen under Kontakter → Lister via listens rækkemenu (Kopiér liste-ID).

Opdater en kontakt #

PUT https://api.youraiconnector.com/v1/contacts/YOUR_CONTACT_ID?apiKey=YOUR_API_KEY
Content-Type: application/json

{
  "customFields": { "company": "Acme Inc" }
}

Kun de felter, du inkluderer, ændres. Dette er også måden at masseindlæse værdier for brugerdefinerede felter efter en import — se Brugerdefinerede felter, kundeemneprofil & noter. Fuldstændige detaljer findes i Kontakt-API’en.

Send en besked (Brugerdefineret kanal) #

POST https://api.youraiconnector.com/v1/send_custom_channel_message?apiKey=YOUR_API_KEY
Content-Type: application/json

{
  "customData": {
    "fromId": "external-contact-id",
    "customChannel": "my-channel",
    "body": "Hello Jane! Your order has been shipped.",
    "campaignId": "optional-campaign-id",
    "firstName": "Jane",
    "lastName": "Smith"
  }
}

Modtag indgående beskeder (Brugerdefineret kanal) #

Modtag beskeder fra eksterne systemer som en brugerdefineret kanal. Det er sådan, integrationer som GoHighLevel sender beskeder ind i Your AI Connector. Se Brugerdefinerede kanaler for alle detaljer.

POST https://api.youraiconnector.com/v1/incoming_custom_channel_message?apiKey=YOUR_API_KEY
Content-Type: application/json

{
  "customData": {
    "messageSid": "unique-message-id",
    "fromId": "external-contact-id",
    "toId": "your-user-id",
    "body": "Customer's message here",
    "channel": "custom",
    "status": "received"
  },
  "messageType": "text"
}

Oversigt over tilgængelige handlinger #

Hastighedsbegrænsning (Rate Limiting) #

API’en håndhæver hastighedsbegrænsninger for at sikre platformens stabilitet. Hvis du overskrider din grænse, returneres 429 Too Many Requests — hold en pause og prøv igen efter det tidsrum, der er angivet i svarhovederne. Ved brug med høj volumen (bulk-import) skal du bruge den indbyggede importfunktion eller sende en e-mail til hi@youraiconnector.com for at få vejledning.

Bedste praksis #

• Opbevar din API-nøgle sikkert — brug en adgangskodeadministrator eller server-side konfiguration, aldrig klient-side kode, som en browserbesøgende kan læse.
• Inkluder altid landekoden i telefonnumre (+1 for USA, +44 for Storbritannien, +31 for Holland).
• Håndter fejl elegant — tjek statuskoder og læs eventuelle fejlmeddelelser, der returneres.
• Håndter dubletter — et duplikeret telefonnummer returnerer { "success": false, "error_code": 409 } i stedet for en ny kontakt, med den eksisterende kontakts ID i contactId.
• Test med et lille datasæt, før du kører bulk-operationer.

Fejlbeskeder #

{
  "error": {
    "code": "INVALID_PHONE",
    "message": "Phone number must include a valid country code."
  }
}

Næste skridt #

• Webhooks — modtag notifikationer i realtid fra appen (et separat afsnit fra din API-nøgle).
• Forbind AI-assistenter (MCP) — brug den samme API-nøgle til at lade Claude styre din konto.
• Facebook Lead-formularer — brug API’en med automatiseringsplatforme til at indfange leads.
• GoHighLevel-integration — et eksempel på en fuld tovejs API-integration.