Wat je nodig hebt
- Een website die bij ons is ingesteld, met een betaald abonnement (Basis, Standaard, Elite of Enterprise). Nog niet gedaan? Meld je aan met je e-mailadres en vul het adres van je website in.
- Een API-sleutel: open in je dashboard Chatapps en API, geef de sleutel een naam (bijvoorbeeld “AstrBot”) en druk op API-sleutel aanmaken. Kopieer hem meteen: hij wordt maar één keer getoond.
- AstrBot (of een andere tool) die draait en gekoppeld is aan je chatapp. In de eigen documentatie van AstrBot staat hoe je het installeert en Discord, Telegram, Slack, WeChat of QQ koppelt.
Dit zijn de drie waarden waar elke tool om vraagt:
API Base URL: https://7x24hrs.com/v1
API Key: sk-7x24-…
Model: 7x24hrs-assistantInstellen in AstrBot
- Open het AstrBot-dashboard en ga naar Providers. Druk op het tabblad Chat Completion op + Add naast Provider Sources.
- Kies in New model provider voor OpenAI Compatible.
- Geef hem een ID die je herkent, zoals
7x24hrs. Plak je sleutel in API Key en zet API Base URL ophttps://7x24hrs.com/v1. - Druk op Save And Fetch Models. Druk onder Available Models op + naast
7x24hrs-assistant. Laat in het venster dat opent onder Model capabilities alleen Text aangevinkt (vink Image, Audio en Tool use uit: de assistent antwoordt met tekst) en druk op Save. - Maak het het model dat je bot gebruikt: kies het in Config als standaard chatmodel (of kies het voor één gesprek met de modelkeuze in Chat).
- Stel een vraag op de pagina Chat van AstrBot of in je gekoppelde chatapp. Het antwoord komt uit de gegevens van je website.
Laat de eigen persona en systeemprompt van AstrBot leeg, of houd ze kort: je assistent volgt je regels en personage uit het 7x24hrs-dashboard en neemt geen instructies aan uit de systeemprompt van de chatapp.
Dify, LobeChat en andere tools
Elke tool met een provider voor “OpenAI-compatibel” of “aangepaste OpenAI” werkt op dezelfde manier: Base URL https://7x24hrs.com/v1, je API-sleutel en het model 7x24hrs-assistant.
- Dify: voeg in Settings → Model Provider OpenAI-API-compatible toe, vul de modelnaam, je sleutel en de Base URL als API-endpoint in, en gebruik het model daarna in je app.
- LobeChat: zet in de instellingen, bij de taalmodellen, de provider OpenAI aan, vul je sleutel in en stel het API-proxyadres in op de Base URL; voeg daarna
7x24hrs-assistanttoe aan de modellijst. - Je eigen code: roep de API aan met een willekeurige OpenAI-clientbibliotheek en stel de base URL en de sleutel in.
Zo probeer je de API uit vanuit een terminal:
curl https://7x24hrs.com/v1/chat/completions \
-H "Authorization: Bearer sk-7x24-…" \
-H "Content-Type: application/json" \
-d '{"model": "7x24hrs-assistant", "user": "visitor-42",
"messages": [{"role": "user", "content": "Do you ship to Canada?"}]}'Met "stream": true komt het antwoord binnen als server-sent events, net als bij OpenAI:
curl -N https://7x24hrs.com/v1/chat/completions \
-H "Authorization: Bearer sk-7x24-…" \
-H "Content-Type: application/json" \
-d '{"model": "7x24hrs-assistant", "stream": true,
"messages": [{"role": "user", "content": "Do you ship to Canada?"}]}'Zo werken antwoorden in chatapps
| Chatknop op je website | Chatapp via de API | |
|---|---|---|
| Antwoordt uit | De gegevens, standaardantwoorden en het personage van je website | Hetzelfde |
| Als hij twijfelt | Zegt dat en geeft de bezoeker aan jou door | Zegt dat en geeft je contactadres in het antwoord |
| Je krijgt een melding | Per e-mail, Slack, Discord of Telegram | Hetzelfde, gemarkeerd met “via API / AstrBot” |
| Zelf de bezoeker antwoorden | Vanuit je chatapp of dashboard | Niet mogelijk vanaf hier: antwoord per e-mail |
| Getelde gesprekken | Eén per bezoeker en gesprek | Hetzelfde, uit hetzelfde maandtegoed |
Bij welke abonnementen horen chatapps?
Bij elk betaald abonnement: Basis $19 per maand voor 90 gesprekken, Standaard $59 voor 275, Elite $199 voor 1.000 en Enterprise $1,099 voor 6.000. Gesprekken via de API tellen mee in hetzelfde maandtegoed als de chatknop. Het gratis abonnement bevat geen chatapps: sleutels die je daarmee maakt, staan op pauze tot je een betaald abonnement kiest. Zie prijzen.
Wat telt als een gesprek?
Eén bezoeker die chat, hoeveel vragen hij ook stelt, precies zoals bij de chatknop. Tools die bij elk verzoek een veld user meesturen, laten ons bezoekers uit elkaar houden; anders wordt een gesprek herkend aan het eerste bericht.
Kan een systeemprompt in AstrBot veranderen wat de assistent zegt?
Nee. Systeemprompts die de chatapp meestuurt, worden niet gevolgd. De assistent houdt zich aan jouw regels: hij antwoordt alleen uit de gegevens van je website, zegt het als hij iets niet weet en belooft niets wat je website niet zegt. Zijn personage is het personage dat je in het dashboard hebt ingesteld.
Worden afbeeldingen, spraakberichten of tool calls ondersteund?
Nog niet. Tekst wordt beantwoord; afbeeldingen en andere bijlagen worden uit een bericht weggelaten, en een bericht zonder tekst krijgt een duidelijke foutmelding. Tooldefinities die de client meestuurt, worden genegeerd.
Wat als een sleutel uitlekt?
Trek hem in bij Chatapps en API: hij werkt dan meteen niet meer. Maak daarna een nieuwe aan en plak die in je tool. Sleutels worden alleen als vingerafdruk bewaard, dus ook wij kunnen een sleutel niet opnieuw tonen.