Skip to main content

Integraties

Koppel je CRM, agenda en tools.

9 min read

Finn werkt het best wanneer het verbonden is met de systemen die je al gebruikt — je CRM, je agenda, je telefonieprovider, de chat van je team. Deze pagina loopt ze stuk voor stuk door, ervan uitgaande dat je nog nooit eerder een integratie hebt opgezet.

Je hebt niet alle integraties nodig. De meeste gebruikers beginnen met alleen een agenda (zodat de Finn afspraken kan inplannen) en eventueel een CRM. Voeg de rest toe wanneer je er een concrete behoefte aan hebt.

Alle koppelingen zijn omkeerbaar. Je kunt alles op elk moment verbreken via hetzelfde scherm waarmee je het hebt verbonden. Het platform houdt je gegevens nooit vast.

Waar je integraties vindt

Zijbalk → Instellingen → Integraties.

Je ziet een tegel voor elke beschikbare integratie met een label dat de status toont: Niet verbonden, Verbonden of Vereist aandacht. Klik op een tegel om te configureren of te beheren.

CRM's

In een CRM bewaar je je klant- en contactgegevens. Door je CRM te koppelen kun je:

  1. Contacten ophalen, zodat je niet handmatig CSV-bestanden hoeft te uploaden.
  2. Gespreksresultaten terugschrijven, zodat je salesteam ziet wat er in elk gesprek is gebeurd zonder het CRM te verlaten.

HubSpot

De configuratie is grotendeels een kwestie van klikken. Reken op 10 minuten.

  1. Instellingen → Integraties → HubSpot → Verbinden.
  2. Je wordt doorgestuurd naar HubSpot. Log in (als je dat nog niet bent) en klik op Autoriseren.
  3. Je keert terug naar Finn met een groene badge "Verbonden".
  4. Bepaal nu wat je wilt importeren. Klik op Lijsten kiezen. Vink de HubSpot-lijsten aan die je als doelgroep wilt gebruiken.
  5. Stel een synchronisatieschema in — elke 15 minuten is een goede standaard voor actieve campagnes; dagelijks volstaat voor lijsten die minder snel veranderen.
  6. Wijs velden toe — geef Finn aan welke HubSpot-eigenschap de naam is, welke het telefoonnummer en welke de landcode. Optioneel: wijs extra eigenschappen toe aan aangepaste velden, zodat de Finn ze tijdens het gesprek kan gebruiken.

Dat is alles. Je HubSpot-lijsten verschijnen nu als doelgroepen in Finn.

Wil je dat gespreksresultaten terug naar HubSpot worden geschreven, schakel dan tijdens de configuratie Outcome Sync in (of later via hetzelfde scherm). Elk afgerond gesprek wordt een HubSpot-engagement; velden uit de nagespreksanalyse worden eigenschapsupdates.

Salesforce

Grotendeels dezelfde stappen als bij HubSpot. Een paar aandachtspunten specifiek voor Salesforce:

  • Je kunt Production of Sandbox koppelen. De configuratie vraagt welke.
  • Rechtenvereisten — je hebt een gebruiker nodig met "API Enabled" en lees-/schrijfrechten op Leads, Contacts en (indien gebruikt) Custom Objects. De meeste CRM-beheerders kunnen dit instellen.
  • Custom objects worden ondersteund. Gebruikt je verkoopproces een custom object (bijvoorbeeld "Opportunity Owner Calls"), dan kun je daaraan toewijzen in plaats van aan de standaard Lead/Contact.

Pipedrive

Pipedrive gebruikt een API-token in plaats van OAuth.

  1. In Pipedrive: Instellingen → Persoonlijke voorkeuren → API → Token genereren.
  2. Plak het token in Finn → Instellingen → Integraties → Pipedrive.
  3. Doorloop de rest van de configuratie zoals bij HubSpot.

"Mijn CRM staat er niet bij"

Gebruik de Webhook-integratie (verderop op deze pagina) om gespreksresultaten te versturen naar elke plek waar je HTTP-verzoeken kunt ontvangen. Of gebruik een tool als Zapier/Make als brug — zie de Zapier-sectie hieronder.

Agenda — voor het inplannen van afspraken

Wil je dat je Finn afspraken inplant, dan moet er een agenda gekoppeld zijn.

Google Calendar

  1. Instellingen → Integraties → Google Calendar → Verbinden.
  2. Log in bij Google en verleen agendarechten.
  3. Kies welke agenda gebruikt wordt voor boekingen. De meeste mensen hebben er meerdere — kies de juiste.
  4. Stel beschikbaarheidsregels in:
    • Werktijden — wanneer boekingen zijn toegestaan
    • Buffer tussen afspraken — minimale tussenruimte tussen opeenvolgende afspraken (bijv. 10 min)
    • Max. afspraken per dag — optionele veiligheidslimiet
  5. Opslaan.

Vanaf nu kun je in elke Finn een taak of workflow-actie "Book Calendar" toevoegen die deze agenda gebruikt.

Microsoft Outlook / Microsoft 365

Hetzelfde als Google. Autoriseer via Microsoft, kies een agenda, stel beschikbaarheid in.

Calendly / Cal.com

Deze werken anders — ze staan geen directe boeking via API toe zoals Google/Outlook dat doen. In plaats daarvan zegt de Finn "Ik stuur je een boekingslink" en gaat er een sms of e-mail uit met de URL.

Dit werkt, maar voelt minder natuurlijk dan direct boeken. Als je de keuze hebt, koppel dan Google of Outlook rechtstreeks.

Telefonieproviders — als je je eigen nummer meeneemt

Heb je al een telefoonnummer bij een andere provider (Twilio, Vonage, je eigen kantoor-PBX), dan kun je dat via Finn blijven gebruiken.

Zie Telefoonnummers → Je eigen nummer meenemen voor de volledige handleiding.

Ondersteunde providers: Twilio, Plivo, Bandwidth, Vonage en generieke SIP-compatibele carriers.

Webhooks — gegevens naar je eigen systemen sturen

Een webhook is een URL aan jouw kant waar Finn gegevens naartoe stuurt zodra er iets gebeurt (een gesprek is afgerond, een deployment is beëindigd, enzovoort).

Handig wanneer:

  • Je wilt dat elk afgerond gesprek in je datawarehouse terechtkomt voor eigen analyses
  • Je een Slack-bericht of e-mail wilt triggeren wanneer er iets specifieks gebeurt
  • Je CRM of bedrijfsapplicatie niet standaard wordt ondersteund, maar wel HTTP-verzoeken kan ontvangen
  • Je Zapier/Make/n8n wilt gebruiken om vervolgacties te automatiseren

Een webhook instellen

  1. Instellingen → Integraties → Webhooks → Endpoint toevoegen.
  2. Voer de URL in waar Finn naartoe moet sturen.
  3. Kies op welke events je je wilt abonneren:
    • Gesprek gestart — wordt geactiveerd zodra een gesprek begint
    • Gesprek afgerond — wordt geactiveerd wanneer een gesprek eindigt (transcript beschikbaar, maar nog niet geanalyseerd)
    • Gesprek geanalyseerd — wordt geactiveerd wanneer de analyse na het gesprek klaar is (het nuttigst voor vervolgautomatisering)
    • Deployment gestart — wordt geactiveerd wanneer een deployment live gaat
    • Deployment afgerond — wordt geactiveerd wanneer een deployment eindigt, inclusief totaalcijfers
  4. Opslaan. Finn toont je een signing secret — bewaar deze op een veilige plek (je ziet hem maar één keer).
  5. Verifieer de signing secret op je endpoint om te bevestigen dat verzoeken echt van Finn komen.

Hoe de gegevens eruitzien

Elk event stuurt JSON naar je URL. Een call.analyzed-event ziet er ongeveer zo uit:

{
  "event": "call.analyzed",
  "call": {
    "id": "call_abc123",
    "deployment_id": "deploy_xyz",
    "started_at": "2026-06-15T10:30:00Z",
    "duration_seconds": 142,
    "contact": { "name": "Alice Chen", "phone_number": "+15551234567" },
    "transcript": [ ...turn-by-turn... ],
    "post_call_analysis": {
      "appointment_booked": true,
      "appointment_time": "2026-06-22 14:00"
    },
    "sentiment": "positive"
  }
}

Het volledige schema staat in onze developer reference op api.hirefinn.ai/docs.

Wanneer webhooks niet werken

Als Finn je endpoint niet kan bereiken (DNS-fout, time-out, 5xx-respons), wordt het opnieuw geprobeerd met backoff tot maximaal 24 uur. Elke mislukte bezorging verschijnt in Instellingen → Integraties → Webhooks → Bezorglog met de foutmelding — handig om te debuggen.

Webhooks tijdens een gesprek (live data opzoeken)

Er bestaat nog een ander soort webhook: een die je Finn tijdens een gesprek aanroept om live data op te zoeken.

Voorbeeld: een klant belt over zijn bestelling. De Finn moet de bestelstatus weten, maar die staat in jouw systeem, niet in Finn. De Finn roept je /lookup-endpoint aan met het telefoonnummer van de klant, jouw endpoint geeft { "order_status": "shipped", "tracking": "1Z..."} terug, en de Finn gebruikt dat in zijn antwoord: "Uw bestelling is gisteren verzonden — het trackingnummer eindigt op..."

Instellen: voeg in de Workflow van je Finn een Actie → Webhook-node toe. Configureer de URL en wat er verzonden wordt. De respons komt beschikbaar als workflowvariabelen.

REST API — voor programmatische besturing

Sommige teams willen Finn vanuit hun eigen code aansturen — deployments programmatisch starten, gespreksdata naar eigen dashboards halen, enzovoort.

Instellingen → Integraties → API-sleutels → Nieuwe sleutel genereren. Kopieer de sleutel en bewaar hem veilig.

Gebruik daarna de API:

POST https://api.hirefinn.ai/v1/deployments
Authorization: Bearer your_api_key

{
  "finn_id": "finn_abc",
  "audience_id": "aud_xyz",
  "from_number": "+15551234567"
}

We hebben officiële SDK's voor Node, Python, Go en Ruby. Volledige referentie op api.hirefinn.ai/docs.

Ben je geen ontwikkelaar en klinkt dit hoofdstuk eng: je hebt het niet nodig. Het dashboard doet alles wat de API doet. De API is alleen voor teams die dingen willen scripten.

Slack — meldingen in je teamchat

Handig voor operationeel overzicht — "deployment X is klaar, dit zijn de cijfers" — zonder dat iedereen in Finn hoeft in te loggen.

  1. Instellingen → Integraties → Slack → Toevoegen aan workspace.
  2. Autoriseer in Slack.
  3. Kies een kanaal voor meldingen.
  4. Kies waarover je meldingen wilt:
    • Deployment gestart
    • Deployment voltooid (met samenvattende cijfers)
    • Deployment mislukt
    • Dagelijkse ochtendsamenvatting
    • Drempelwaarschuwingen (bijv. "succespercentage onder X gezakt")

Je kunt meerdere kanalen koppelen — verschillende teams willen mogelijk verschillende meldingstypen.

Zapier / Make / n8n

Voor no-code-automatisering gebruik je de Webhook-integratie hierboven als triggerbron in je favoriete automatiseringstool.

We werken ook aan een native Zapier-app — vraag vroege toegang aan via Instellingen → Integraties → Zapier.

SSO (Enterprise)

Met Single Sign-On logt je team in met de bestaande bedrijfsidentiteit (Okta, Azure AD, Google Workspace, enz.) in plaats van aparte Finn-wachtwoorden.

Beschikbaar op Enterprise-abonnementen.

  • SAML 2.0 — werkt met alle grote identityproviders.
  • SCIM — geautomatiseerde gebruikersprovisioning. Voeg je iemand toe aan de juiste groep in je IdP, dan krijgt die persoon automatisch een Finn-account. Verwijder je iemand, dan vervalt de toegang.

De configuratie gebeurt onder Instellingen → Beveiliging → SSO. De IT-teams van de meeste bedrijven hebben dit eerder gedaan — de flow is standaard.

Compliance en dataresidentie

Niet echt een integratie, maar goed om te weten:

  • GDPR — volledig ondersteund. Recht op verwijdering, export, EU-dataresidentie.
  • HIPAA — alleen Enterprise, met ondertekende BAA.
  • SOC 2 Type II — actueel. Auditrapporten beschikbaar onder NDA.
  • Dataresidentie — kies bij het aanmaken van het account de regio VS, EU of India. (Kan later niet worden verplaatst zonder handmatige migratie — kies zorgvuldig bij aanmelding.)

Meer op hirefinn.ai/platform/security.

Veelgestelde vragen

V: Kan ik tussen meerdere CRM's tegelijk synchroniseren? A: Ja. Elke CRM-verbinding staat op zichzelf. Verschillende doelgroepen kunnen vanuit verschillende CRM's synchroniseren.

V: Mijn webhook vuurt wel, maar mijn systeem ontvangt de data niet. A: Controleer Instellingen → Integraties → Webhooks → Bezorglog voor de foutmelding. Meest voorkomend: probleem met SSL-certificaat, IP-blokkade of een endpoint dat geen 200 teruggeeft.

V: Ik heb mijn CRM per ongeluk losgekoppeld. Ben ik data kwijt? A: Nee. Loskoppelen stopt alleen toekomstige synchronisaties. Alle bestaande doelgroepdata, gespreksgeschiedenis enzovoort blijft behouden. Koppel opnieuw wanneer je er klaar voor bent.

V: Kan ik de API en het dashboard voor hetzelfde account gebruiken? A: Ja. Veel teams gebruiken de API voor automatisering en het dashboard voor handmatige handelingen. Beide weerspiegelen dezelfde onderliggende status.

Volgende

Was this page helpful?

Still stuck or have feedback?

Email [email protected] or use the chat bubble in the bottom-right corner — it's a Finn that knows the Academy cold.