Salesbase
← Udvikler-hub

AI-AGENTER

Styr Salesbase
med Claude, Cursor m.fl.

Salesbase serverer en komplet Markdown-reference til AI-agenter. Giv agenten MD-filen (eller URL), en workspace API-nøgle i miljøvariabler, og klare regler. Så kan den læse CRM-data, oprette leads og automatisere integrationer ud fra den samme dokumentation som udviklere bruger.

Download API MarkdownÅbn docs i appen

Markdown (anbefalet)

https://app.salesbase.dk/api/v1/docs/markdown

JSON (maskinlæsbar)

https://app.salesbase.dk/api/v1/docs?full=true

OVERBLIK

Hvad er MD-filen?
Og hvorfor bruge den?

Filen genereres live fra Salesbase API-registry. Den indeholder autentifikation, rate limits, alle integrations-endpoints, webhook-events og eksempler. Mobilapp-endpoints er filtreret fra, så agenten kun ser det der virker med API-nøgle.

1

Hent MD-referencen

Download eller peg agenten mod den offentlige Markdown-fil. Den opdateres fra samme registry som API-dokumentationen i appen.

2

Giv agenten en API-nøgle

Opret en nøgle under Indstillinger → API & Webhooks. Gem nøglen i miljøvariabel, aldrig i repo eller prompts der deles.

3

Bind regler til projektet

Tilføj MD-URL og sikkerhedsregler i Cursor Rules, CLAUDE.md eller tilsvarende, så agenten kender endpoints før den handler.

4

Test read-only først

Start med GET (companies, leads, deals). Når flowet virker, kan agenten oprette/opdatere via POST og PUT.

OPSÆTNING

Per værktøj
Cursor, Claude Code, Claude Desktop

Samme MD-kilde til alle. Forskel er kun hvordan du injecter den i agentens kontekst.

Cursor

  1. Download MD: brug Download-knappen i appen under Dokumentation, eller hent fra MD-URL.
  2. Project Rules: indsæt regler med MD-URL og auth-krav (se eksempel nedenfor).
  3. Docs: tilføj https://app.salesbase.dk/api/v1/docs/markdown som ekstern doc-kilde hvis dit setup understøtter det.
  4. Bed agenten læse referencen før den skriver integrationskode.

Claude Code

  1. Opret CLAUDE.md i repo-roden med MD-URL og API-base (se eksempel).
  2. Sæt SALESBASE_API_KEY i miljø (.env) og load det i terminal-session.
  3. Bed Claude hente MD ved opstart: curl eller @web fetch mod MD-URL.
  4. Brug eksplicit read-only prompts indtil du stoler på flowet.

Claude Desktop & andre agenter

  1. Upload salesbase-api-docs.md (download fra app eller MD-URL) som projektviden.
  2. Gentag upload når API'et får nye endpoints (filen opdateres løbende).
  3. Alternativt: peg agenten på JSON-URL for struktureret parsing.
  4. Del aldrig API-nøglen i chat; brug lokale scripts med env vars.

EKSEMPLER

Kopiér direkte
til dit projekt

Tilpas navne og stier. Hold API-nøglen ude af git.

Cursor Project Rules

markdown
# Salesbase API

Før du kalder Salesbase API, læs den officielle reference:
https://app.salesbase.dk/api/v1/docs/markdown

- Base URL: https://app.salesbase.dk/api/v1
- Auth: Authorization: Bearer sb_<API_KEY> (aldrig i git)
- Rate limit: 120/min, 50.000/dag
- Kun integrations-endpoints (mobil/JWT-endpoints er uden for scope)

Når du bygger integrationer: brug GET/POST/PUT/DELETE mod /api/v1/* og respekter workspace isolation.

CLAUDE.md (Claude Code)

markdown
# Salesbase CRM API

## Reference
Hent og følg API-dokumentationen her (opdateres løbende):
https://app.salesbase.dk/api/v1/docs/markdown

## Autentifikation
- Header: Authorization: Bearer $SALESBASE_API_KEY
- Opret nøgle: Indstillinger → API & Webhooks i appen

## Arbejdsregler for agenten
1. Læs MD-referencen før nye endpoints bruges
2. Brug kun dokumenterede /api/v1 integrations-endpoints
3. Bekræft destructive handlinger (DELETE, bulk) med brugeren
4. Log fejl fra API (status + error body) og foreslå fix

Miljøvariabler

env
# Lokalt (.env — aldrig commit)
SALESBASE_API_KEY=sb_din_nøgle_her
SALESBASE_API_BASE=https://app.salesbase.dk/api/v1

Testforbindelse

bash
curl -s 'https://app.salesbase.dk/api/v1/companies?limit=1' \
  -H "Authorization: Bearer $SALESBASE_API_KEY"

Eksempel-prompt til agent

text
Du har adgang til Salesbase CRM via REST API.
Læs https://app.salesbase.dk/api/v1/docs/markdown for endpoints, felter og eksempler.

Opgave: Find alle åbne deals over 50.000 kr uden aktivitet i 14 dage.
Brug kun GET-kald først. Vis mig planen før du laver ændringer.

SIKKERHED

Gode vaner
når agenter har API-adgang

  • Brug dedikerede API-nøgler til agenter. Tilbagekald dem når opgaven er færdig.
  • Gem nøgler i miljøvariabler eller hemmelighedslager. Aldrig i Markdown, git eller delte chats.
  • Bed agenten bekræfte destructive kald (DELETE, bulk SMS, import) før de køres.
  • Start read-only. Giv write-adgang først når du har set korrekte GET-resultater fra dit workspace.

Klar til at give agenten adgang?

Download Markdown-referencen og opret en API-nøgle med passende scope.

Download MarkdownSe API-reference