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.

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

The API enforces rate limits to ensure platform stability. Exceeding your limit returns 429 Too Many Requests — back off and retry after the time indicated in the response headers. For high-volume use cases (bulk imports), use the built-in import feature or email hi@youraiconnector.com for guidance.

Bedste praksis #

• Opbevar din API-nøgle sikkert — brug en adgangskodeadministrator eller konfiguration på serversiden, aldrig klient-side kode, som en browserbruger 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. Slå kontakten op først, hvis du har brug for at arbejde med den.
• Test med et lille datasæt, før du kører masseoperationer.

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.