Sleak API

De Sleak.chat API biedt directe toegang tot onze infrastructuur voor het bouwen van betrouwbare AI agents. Via onze REST API kun je conversations aanmaken en berichten uitwisselen met je chatbots.

Is werken met de API voor jou te complex? Gebruik dan onze n8n community node voor low-code integratie

Start een nieuwe conversatie

post

Creëert een nieuwe chatconversatie met de opgegeven chatbot.

Authorizations

bearerAuth

AuthorizationstringRequired

Gebruik je API sleutel als Bearer token. Voorbeeld: Authorization: Bearer 28339789ad921d554cddc678e3e91bd3ff6676cb209741aa30b818135ef33060

Body

application/json

chatbot_idstringRequired

Unieke identifier van de chatbot

Example: 307e6946-bc23-4fb7-8458-d8121465f2aq

visitor_idstringOptional

Optionele identifier voor de bezoeker. Als deze niet wordt opgegeven, wordt automatisch een unieke ID gegenereerd.

Example: c428c263-a1d3-4072-bf64-525cefbfb0b1

Responses

200

Conversatie succesvol aangemaakt

application/json

400

Ongeldige aanvraag

application/json

401

Geen geldige API sleutel opgegeven

application/json

403

API sleutel heeft geen toegang tot deze chatbot

application/json

404

Chatbot niet gevonden

application/json

429

Rate limit overschreden

application/json

500

Interne server fout

application/json

post

/api/conversation

HTTPcURLJavaScriptPython

POST /api/conversation HTTP/1.1
Host: api.v1.sleak.chat
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 105

{
  "chatbot_id": "307e6946-bc23-4fb7-8458-d8121465f2aq",
  "visitor_id": "c428c263-a1d3-4072-bf64-525cefbfb0b1"
}

{
  "conversation_id": "63907bf7-89f7-421a-9f13-b6f23411aabv"
}

Verstuur een bericht

post

Verstuurt een bericht naar een bestaande conversatie en ontvangt het antwoord van de chatbot. De conversatie moet eerder aangemaakt zijn via het /api/conversation endpoint.

Authorizations

bearerAuth

AuthorizationstringRequired

Gebruik je API sleutel als Bearer token. Voorbeeld: Authorization: Bearer 28339789ad921d554cddc678e3e91bd3ff6676cb209741aa30b818135ef33060

Body

application/json

conversation_idstringRequired

Identifier van de conversatie

Example: 8337afe2-2158-4332-a8aa-2946a357606p

messagestring · min: 1 · max: 4000Required

Het bericht dat naar de chatbot wordt gestuurd

Example: Hallo, ik heb een vraag over jullie producten

Responses

200

Bericht succesvol verwerkt

application/json

400

Ongeldige aanvraag

application/json

401

Geen geldige API sleutel opgegeven

application/json

403

API sleutel heeft geen toegang tot deze conversatie

application/json

404

Conversatie niet gevonden

application/json

429

Rate limit overschreden

application/json

500

Interne server fout

application/json

post

/api/message

HTTPcURLJavaScriptPython

POST /api/message HTTP/1.1
Host: api.v1.sleak.chat
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 116

{
  "conversation_id": "8337afe2-2158-4332-a8aa-2946a357606p",
  "message": "Hallo, ik heb een vraag over jullie producten"
}

{
  "messages": [
    {
      "id": "msg_123456",
      "type": "ai_response",
      "message_type": "default_bot",
      "body": "Hallo! Ik help je graag met vragen over onze producten.",
      "message_type_data": {},
      "outputlogs": {}
    }
  ],
  "chat_id": "text",
  "process_time": 1,
  "source_documents": [
    {}
  ],
  "execution_metrics": {}
}

---