Forbinder SMOC med REST API

Enkel guide, der viser, hvordan du forbinder til SMOC REST API fra din egen kode, synkroniseringsjobs eller CRM-pipelines. Kundetaster er virksomhedsafgrænsede og som standard skrivebeskyttede. Skrivemulighedstaster kan foretage begrænsede skrivninger, herunder afsendelse fra indbakken; de kan ikke redigere flowdiagrammer, udgive flows eller starte LinkedIn-udsendelseskampagner. Superbrugertaster kan gemme kladder af flows og temaer på de samme POST /api/v2/{toolName}-kald; udgivelse kræver stadig en person i Studio eller Console. Domæneværktøjer findes på REST v2 som POST /api/v2/{toolName} (samme håndteringer som MCP). Fuld liste over kald: REST v2 API reference. GET /api/company/mongocontact bruges til Zapier.

Hent din API-nøgle

1. Gå til Indstillinger → Integrationer → API i SMOC Console.
2. Giv eventuelt nøglen et navn og en udløbsdato (7, 30 eller 90 dage). Lad udløb stå på Ingen udløb, hvis du ikke ønsker, at den skal udløbe.
3. Generér nøglen og kopier den med det samme — den vises kun én gang, så opbevar den et sikkert sted.

Din nøgle er knyttet til din virksomhed. Hver anmodning foretaget med den er automatisk afgrænset til dine data. Generering af en ny nøgle tilbagekalder ikke eksisterende nøgler. Udstedte nøgler vises på samme side — tilbagekald ubrugte nøgler der. MCP-siden bruger de samme kontroller — se skærmbilledet i MCP-guiden.

Base URL

Base URL: https://api.smoc.ai

Fuld kontakt-endpoint:

GET https://api.smoc.ai/api/company/mongocontact

Godkendelse

Legacy-kontakter: send nøglen i et brugerdefineret HTTP-header med navnet token. REST v2 accepterer Authorization: Bearer eller token.

GET /api/company/mongocontact HTTP/1.1
Host: api.smoc.ai
token: YOUR_SMOC_API_KEY

Brug ikke Clerk secret keys (sk_…) eller publishable keys (pk_…).

Hvilke funktioner findes

REST v2 — POST /api/v2/{toolName}

Spejler MCP domæneværktøjer (contacts_search, cpcs_overview, inbox_threads_list og resten). OpenAPI: GET /api/v2 eller GET /api/v2/openapi.json. Se REST v2 reference.

List virksomhedskontakter — GET /api/company/mongocontact (Zapier / kompatibel)

Returnerer en side med kontakter for virksomheden på nøglen samt samlede tællinger.

Hvad den returnerer

• Kontaktoplysninger: navn, e-mail, telefon, status, adresse, dato for sidste samtale, besøg/UTM-historik, spørgeskemasvar, brugerdefinerede tekstfelter, henvisnings- og kampagnedata, når det er indsamlet. Positive beskedflow-smartleads er standardleads (status: "1") og inkluderer også leadSentiment, leadCapturedAt og tags, når de findes.
• leadsCount — kontakter med status lead (inklusive ikke angivet)
• customerCount — kontakter med status kunde

Tællinger dækker alle virksomhedskontakter, ikke kun den aktuelle side.

Query-parametre

Parameter	Standard	Beskrivelse
limit	100	Maksimalt antal kontakter, der returneres (1–500)
sortByField	(ingen)	Sortér faldende efter createdAt, updatedAt, lastConversationDate eller leadCapturedAt
status	(ingen)	Filtrer efter kontaktstatus. status=1 er den standard lead-undersøgelse og inkluderer positive beskedflow-smartleads

Kontaktstatusværdier: "1" lead, "2" kunde, "3" tabt, "4" konverteret.

Kundetaster kan ikke oprette, opdatere eller slette kontakter. Der er ingen cursor-paginering på mongocontact — brug limit og spor sete ID'er på klientsiden, eller brug Zapier-polling. Mere avanceret søgning er POST /api/v2/contacts_search.

Feltniveau-responsformater findes i Public Contacts API reference.

Eksempel på anmodning

curl -s \
  -H "token: YOUR_SMOC_API_KEY" \
  "https://api.smoc.ai/api/company/mongocontact?status=1&limit=25&sortByField=leadCapturedAt"

Hvad er ikke på kunde-API'et

Skrivemulighedstaster kan stadig ikke udgive et flow, slå live til (flowcharts_set_active), slette poster eller starte en LinkedIn-udsendelseskampagne. Indbakke-send er tilvalg på en skrivemulighedsnøgle (inbox_threads_send, kun tekst, kræver idempotencyKey). Brug SMOC MCP fra Claude, Cursor eller VS Code for de samme værktøjer via MCP.

Sikkerhedsnoter

• Nøglen vises kun én gang ved oprettelse — opbevar den i en password manager eller som miljøvariabel.
• Commit aldrig nøglen til et Git-repository.
• Kundetaster er begrænset til din virksomheds data. Standardnøgler er skrivebeskyttede; skrivninger, herunder indbakke-send, er tilvalg.
• Tilbagekald ubrugte nøgler fra listen over udstedte nøgler under Indstillinger → Integrationer → API.

Fejlfinding

• 401 Manglende token-header: send token: <key>, ikke Authorization: Bearer.
• 401 Ugyldig eller tilbagekaldt token: bekræft, at nøglen er korrekt og ikke er blevet tilbagekaldt.
• 422 limit må ikke overstige 500: sænk limit query-parameteren.
• 422 Ugyldig statusværdi: brug 1, 2, 3 eller 4.

Se også

• REST v2 API reference — alle POST /api/v2/{toolName}-kald
• Forbind SMOC med REST API
• Public Contacts API
• MCP til Claude, Cursor og VS Code