Wat het doet
- Vóór het gesprek: als je systeem de functie lookup_caller aanbiedt, herkent Twilper de beller of bezoeker.
- Tijdens het gesprek: de AI roept de tools van je systeem aan (bijvoorbeeld producten zoeken, orderstatus, opties en prijzen). In de websitechat ziet de bezoeker dan "Even opzoeken…".
- Orderdetails geeft de AI pas na een ordernummer plus e-mailadres of postcode.
Wat je nodig hebt
- Een https-endpoint in je eigen systeem, gebouwd volgens de beschrijving op twilper.com/integrations/api.
- Een ondertekeningssleutel van minimaal 32 tekens (of laat Twilper er een maken).
Instellen
Stap 1: Open de botkoppeling
Ga naar "Integraties" en scrol naar "Koppeling met je eigen systeem (botkoppeling)".
Stap 2: Vul het endpoint in
Vul bij "Endpoint-URL" het adres van je systeem in, bijvoorbeeld https://jouwsite.nl/api/twilper/channel.
Stap 3: Sleutel en activeren
Plak je eigen sleutel bij "Ondertekeningssleutel" of laat het veld leeg om er een te laten maken. Vink "Koppeling actief" aan en klik op "Opslaan".
Regels en instellingen
- Elk verzoek is ondertekend met HMAC-SHA256. Je systeem moet de handtekening controleren en verzoeken zonder geldige handtekening weigeren.
- Elk verzoek bevat een context met kanaal, beller of bezoeker en of de identiteit gecontroleerd is. Geef alleen gegevens terug die bij die persoon horen.
- De AI gebruikt dezelfde tools in websitechat, WhatsApp en telefoon.
Testen
- Gebruik "Test de koppeling" op de kaart: kies een kanaal (Websitechat, WhatsApp of Telefoon), typ een bericht zoals "Waar is mijn bestelling?" en klik op "Verstuur test". Je ziet het antwoord en welke tools de AI mag aanroepen.
- Stel daarna dezelfde vraag in de echte websitechat en controleer de logs van je systeem.
Veelvoorkomende problemen
- De AI antwoordt zelf in plaats van je systeem: je endpoint antwoordde niet binnen 6 seconden (tools: 4 seconden) of gaf een fout. Twilper valt dan terug op de ingebouwde AI.
- Handtekening klopt niet: controleer of je de ruwe body gebruikt en dezelfde sleutel als in Twilper.
Goed om te weten
- Werk je met WooCommerce? Dan heb je de botkoppeling niet nodig: gebruik de WooCommerce-kaart.