Koppelingen met Zapier en Make

Koppelingen met Zapier en Make

Stuur gesprekken, terugbelverzoeken en afspraken automatisch door naar je eigen systemen, of naar Zapier en Make om duizenden apps te koppelen. Bijvoorbeeld: elk nieuw terugbelverzoek als taak in je planning.

Zo koppel je het

Je vindt een link naar deze koppelingen ook in het tabblad Na het gesprek van je assistent.

1. Ga naar Koppelingen in het menu en open het tabblad Beschikbaar.
2. Kies Zapier, Make, Eigen webhook of een programma zoals Teamleader of Google Sheets, en klik op Koppelen. Je ziet dan de stappen.
3. Maak een webadres aan waar we berichten heen sturen. In Zapier maak je een Zap met als trigger Webhooks by Zapier en kies je Catch Hook. In Make start je een scenario met Webhooks en kies je Custom webhook. Kopieer het webadres dat je krijgt.
4. Plak het adres en klik op Opslaan en testen. We sturen meteen een testbericht, zodat Zapier of Make een voorbeeld ziet en je verder kunt bouwen.
5. Wil je meer dan Gesprek afgerond doorsturen? Kies dan vooraf bij Wat sturen we door? de berichten die je wilt.

Werk je met een eigen systeem? Bewaar dan de geheime sleutel onder Voor ontwikkelaars. Je ziet hem maar een keer. Voor Zapier en Make heb je hem niet nodig.

Je koppelingen staan daarna in het tabblad Gekoppeld. Daar zet je ze aan of uit. Via Beheren en logboek zie je de laatste berichten, pas je een koppeling aan of maak je een nieuwe sleutel.

Controleer bij Zapier of Webhooks by Zapier in je Zapier-abonnement zit.

Welke berichten sturen we?

• Gesprek afgerond: samenvatting, uitkomst en eventueel terugbelverzoek.
• Nieuw terugbelverzoek en Terugbelverzoek bijgewerkt, bijvoorbeeld als gedaan gemarkeerd.
• Afspraak gemaakt, Afspraak geannuleerd en Afspraak verzet.

Opnames sturen we nooit mee. Het volledige gesprek sturen we alleen mee als je Volledig gesprek meesturen aanzet. Dat bevat persoonsgegevens van je bellers: zet het alleen aan als je systeem die veilig bewaart.

Als een bericht niet aankomt

We proberen het opnieuw na 1 minuut, 5 minuten, 30 minuten, 2 uur, 6 uur en 24 uur. Na 20 mislukte pogingen op rij zetten we de koppeling uit en krijg je een melding. Controleer dan het adres en zet de koppeling weer aan. Bij elke koppeling zie je de laatste berichten en of ze zijn afgeleverd.

Voor ontwikkelaars: berichten controleren

Elk bericht is een POST met JSON naar je adres, met de velden id, type, created_at en data. Je adres moet met https:// beginnen. Antwoord binnen 10 seconden met een 2xx-status. Een doorverwijzing telt als mislukt.

Elk bericht heeft deze kopteksten:

• X-Loekas-Event: het soort bericht, bijvoorbeeld call.completed.
• X-Loekas-Delivery: het id van het bericht. Dat blijft bij een nieuwe poging hetzelfde, zodat je dubbele berichten herkent.
• X-Loekas-Signature: de handtekening, in de vorm t=1760000000,v1=4f2a... (v1 is 64 tekens lang).

Zo controleer je of een bericht echt van ons komt:

1. Haal t en v1 uit X-Loekas-Signature. t is de tijd in seconden (Unix-tijd), v1 is de handtekening.
2. Zet t, een punt en de ruwe body achter elkaar: t + "." + body. Gebruik de body precies zoals je hem ontving, niet een opnieuw opgebouwde JSON.
3. Bereken daarover een HMAC-SHA256 met je geheime sleutel, als hexadecimale tekst.
4. Vergelijk de uitkomst met v1, het liefst met een vergelijking in constante tijd.
5. Weiger het bericht als t meer dan 5 minuten van de huidige tijd afwijkt.

Een voorbeeld in Node.js staat op de pagina Koppelingen beheren, onder Voor ontwikkelaars: berichten controleren. Sleutel kwijt of uitgelekt? Klik daar op Nieuwe sleutel. De oude sleutel werkt daarna meteen niet meer.

Wat kost het?

• Zit in het Groeien-pakket.
• Met Starter boek je het los bij voor EUR 15 per maand (excl. btw). Dat doe je bij Facturatie, onder Uitbreidingen.
• Tijdens je proefperiode probeer je het gratis, met maximaal 2 koppelingen.
• Je kunt maximaal 10 koppelingen maken.