Koble SMOC til REST API

Enkel guide som viser hvordan du kobler til SMOC REST API fra din egen kode, synkroniseringsjobber eller CRM-pipelines. Kundetaster er som standard knyttet til selskapet og er skrivebeskyttet. Skriveaktiverte nøkler kan gjøre begrensede skrivinger, inkludert å sende fra innboksen; de kan ikke redigere flytgrafene, publisere flyter eller starte LinkedIn-utsendelser. Superbruker-nøkler kan lagre utkast til flyt og tema på samme POST /api/v2/{toolName}-kall; publisering krever fortsatt en person i Studio eller Console. Domeneverktøy finnes på REST v2 som POST /api/v2/{toolName} (samme håndterere som MCP). Full samtaleliste: REST v2 API-dokumentasjon. GET /api/company/mongocontact brukes for Zapier.

Hent din API-nøkkel

1. Gå til Innstillinger → Integrasjoner → API i SMOC Console.
2. Gi eventuelt nøkkelen et navn og en utløpsdato (7, 30 eller 90 dager). La utløp stå på Ingen utløpsdato hvis du ikke vil at den skal utløpe.
3. Generer nøkkelen og kopier den med én gang — den vises kun én gang, så lagre den et sikkert sted.

Nøkkelen din er knyttet til ditt selskap. Alle forespørsler gjort med den er automatisk avgrenset til dine data. Å generere en ny nøkkel vil ikke tilbakekalle eksisterende nøkler. Utstedte nøkler listes på samme side — tilbakekall ubrukte nøkler der. MCP-siden bruker de samme kontrollene — se skjermbildet i MCP-guiden.

Base-URL

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

Full kontakt-endepunkt:

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

Autentisering

Legacy-kontakter: send nøkkelen i en egendefinert HTTP-header kalt token. REST v2 aksepterer Authorization: Bearer eller token.

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

Ikke bruk Clerk secret keys (sk_…) eller publishable keys (pk_…).

Hvilke funksjoner finnes

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

Speiler MCP domeneverktøy (contacts_search, cpcs_overview, inbox_threads_list, og resten). OpenAPI: GET /api/v2 eller GET /api/v2/openapi.json. Se REST v2-dokumentasjonen.

List selskapets kontakter — GET /api/company/mongocontact (Zapier / kompatibel)

Returnerer en side med kontakter for selskapet på nøkkelen, samt samlede tellinger.

Hva den returnerer

• Kontaktoppføringer: navn, e-post, telefon, status, adresse, siste samtaledato, besøks-/UTM-historikk, undersøkelsessvar, egendefinerte tekstfelt, henvisnings- og kampanjedata når det er samlet inn. Positive meldingsflyt smart-leads er standard leads (status: "1") og inkluderer også leadSentiment, leadCapturedAt og tags når de finnes.
• leadsCount — kontakter med status lead (inkludert ikke satt)
• customerCount — kontakter med status kunde

Tellingene dekker alle selskapets kontakter, ikke bare den nåværende siden.

Spørringsparametere

Parameter	Standard	Beskrivelse
limit	100	Maks antall kontakter som returneres (1–500)
sortByField	(ingen)	Sorter synkende etter createdAt, updatedAt, lastConversationDate eller leadCapturedAt
status	(ingen)	Filtrer etter kontaktstatus. status=1 er standard lead-undersøkelse og inkluderer positive meldingsflyt smart-leads

Kontaktstatus-verdier: "1" lead, "2" kunde, "3" tapt, "4" konvertert.

Kundenøkler kan ikke opprette, oppdatere eller slette kontakter. Det er ingen cursor-paginering på mongocontact — bruk limit og spor brukte ID-er på klientsiden, eller bruk Zapier polling. Rikere søk er POST /api/v2/contacts_search.

Responsformater på feltnivå finnes i Public Contacts API-dokumentasjonen.

Eksempel på forespørsel

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

Hva som ikke finnes på kunde-API-et

Skriveaktiverte nøkler kan fortsatt ikke publisere en flyt, slå på live (flowcharts_set_active), slette oppføringer eller starte LinkedIn-utsendelser. Innboks send er valgfritt på en skriveaktivert nøkkel (inbox_threads_send, kun tekst, krever idempotencyKey). Bruk SMOC MCP fra Claude, Cursor eller VS Code for de samme verktøyene over MCP.

Sikkerhetsnotater

• Nøkkelen vises kun én gang ved opprettelse — lagre den i en passordbehandler eller miljøvariabel.
• Aldri legg nøkkelen inn i et Git-repositorium.
• Kundenøkler er begrenset til ditt selskaps data. Standardnøkler er skrivebeskyttet; skrivinger inkludert innboks send er valgfritt.
• Tilbakekall ubrukte nøkler fra listen over utstedte nøkler under Innstillinger → Integrasjoner → API.

Feilsøking

• 401 Mangler token-header: send token: <key>, ikke Authorization: Bearer.
• 401 Ugyldig eller tilbakekalt token: sjekk at nøkkelen er korrekt og ikke er tilbakekalt.
• 422 limit må ikke overstige 500: senk limit spørringsparameteren.
• 422 Ugyldig statusverdi: bruk 1, 2, 3 eller 4.

Se også

• REST v2 API-dokumentasjon — alle POST /api/v2/{toolName}-kall
• Koble SMOC med REST API
• Public Contacts API
• MCP for Claude, Cursor og VS Code