Geef je Dify-agents een telefoon: de Famulor-plugin voor Dify

Chatbots kunnen tegenwoordig veel: vragen beantwoorden, leads kwalificeren, formulieren vervangen. Maar sommige gesprekken horen aan de telefoon thuis. De terugbelactie na een aanvraag, de afspraakbevestiging, de snelle follow-up wanneer iemand vastloopt in de chat. Tot nu toe betekende dit dat je gegevens uit je chatbot moest exporteren, ergens moest opslaan en het gesprek apart moest aansturen.

Met de Famulor-plugin voor Dify gebeurt dit alles in één workflow. Je Dify-agent kwalificeert de lead in de chat, maakt het contact aan, voert een echt telefoongesprek met je Famulor-assistent en leest vervolgens de samenvatting en transcriptie weer in. Dit artikel laat zien wat de plugin doet, hoe een typische flow eruitziet en hoe je deze in vier stappen instelt.

Wat is er nieuw?

De Famulor-plugin is nu beschikbaar in de Dify Marketplace. De plugin-ID is famulor/famulor en de huidige versie is 0.1.1. De broncode is openbaar op GitHub.

Je Dify-agents, chatflows en workflows kunnen nu direct samenwerken met je Famulor-workspace: assistenten weergeven, uitgaande gesprekken starten, gespreksresultaten en transcripties lezen, contacten aanmaken en campagnes starten.

Wat de plugin doet: 7 tools

Je kunt de tools gebruiken in een agent die zelf beslist wanneer hij welke tool aanroept, of ze toevoegen als vaste stappen in een workflow.

Use case: van chat naar terugbelactie met transcriptie

Een typisch scenario: een Dify-chatbot draait op je website. Een prospect stelt vragen, de bot merkt oprechte interesse op en biedt een terugbelactie aan. Dit is de flow:

1. Kwalificeer de lead in de chat. Je Dify-chatflow verzamelt de naam, het telefoonnummer en het verzoek, en vraagt om toestemming om terug te bellen.
2. Maak het contact aan. Create Contact voegt de lead toe aan je Famulor-workspace. Als het contact al bestaat, wordt het samengevoegd in plaats van gedupliceerd.
3. Start het gesprek. Start Outbound Call gebruikt het assistant_id van je assistent en het nummer in E.164-formaat, bijvoorbeeld +4930123456. Geef context uit de chat mee als JSON in Variables, zoals {"customer_name": "Ada", "order_id": "A-1001"}. Je assistent weet direct waar het gesprek over gaat en hoeft niet alles opnieuw te vragen.
4. Lees het resultaat. Een latere Get Call-stap leest de status, samenvatting, analyse en transcriptie van het gesprek.
5. Ga door. Met die gegevens bepaalt je workflow de volgende stap: het CRM bijwerken, een follow-up sturen of overdragen aan je team.

Het voordeel: chat en telefoon lopen niet langer naast elkaar. Wat in de chat is gezegd, vloeit in het gesprek, en wat er tijdens het gesprek is gebeurd, vloeit terug in je workflow. Als je gespreksgegevens ook wilt pushen zonder te pollen, lees dan ons artikel over post-call webhooks.

Meer ideeën voor je workflows

• Afspraakbevestiging na een formulier: Iemand vult een formulier in, je workflow maakt het contact aan en een assistent belt om te bevestigen.
• Terugbelactie na een support-chat: Wanneer de chatbot een probleem niet kan oplossen, biedt hij een terugbelactie aan in plaats van het gesprek te laten doodlopen.
• Start een campagne vanuit je agent: Gebruik List Campaigns om de juiste campagne te vinden en Start Campaign om deze te lanceren, direct vanuit je Dify-app.
• Gesprekken beoordelen in de chat: Vraag je agent bijvoorbeeld: "Welke assistenten heb ik?" of "Vat mijn laatste 5 voltooide gesprekken samen". Hiervoor gebruikt hij List Assistants, List Calls en Get Call.

Instellen in 4 stappen

1. Een Famulor-workspace met API-toegang. Je hebt een workspace nodig waarvan het abonnement of de add-on API-toegang bevat. Nog geen account? Meld je hier aan.
2. Maak een API-sleutel aan. Open in Famulor Settings → API & MCP en maak een API-sleutel aan. Kopieer deze direct: hij begint met fam_ en wordt slechts één keer getoond.
3. Installeer de plugin in Dify. Installeer de plugin vanuit de Dify Marketplace, open Tools → Famulor → Authorize en plak de sleutel. Wanneer je opslaat, controleert de plugin je inloggegevens met een read-only verzoek.
4. Controleer de Base URL. Laat de Base URL staan op https://app.famulor.io. Wijzig deze alleen als je Famulor gebruikt onder je eigen white-label domein. Alleen HTTPS wordt geaccepteerd.

Tip: een sleutel uit het dashboard heeft volledige toegang tot je workspace. Als je de rechten wilt beperken, kun je via de API een sleutel met nauwere scopes aanmaken. De scopes die elke tool nodig heeft, staan vermeld in de README van de plugin. Je vindt alle endpoints in de Famulor API-referentie, en een breder overzicht van API-integraties in ons artikel over API-integraties voor voice AI-agents.

Gebruik het verantwoord

Start Outbound Call en Start Campaign bereiken echte mensen. Behandel deze anders dan read-only tools:

• Schakel de bel- en campagnetools alleen in agent-apps in wanneer je gebruikers daadwerkelijk gesprekken moeten kunnen starten.
• Zorg ervoor dat je een wettelijke basis hebt en, waar vereist, toestemming voor uitgaande gesprekken in jouw land.
• Test nieuwe flows eerst met je eigen nummer voordat echte leads worden gebeld.

De plugin voert nooit automatisch schrijfacties uit, zoals het starten van een gesprek, het aanmaken van een contact of het starten van een campagne. Zo voorkom je dubbele gesprekken als een verzoek mislukt.

Bonus: werk je liever met n8n?

Als je je automatiseringen liever in n8n bouwt, is er een community-node, n8n-nodes-famulor, beschikbaar op npm.

Afsluiting

De Famulor-plugin geeft je Dify-agents een stem aan de telefoon. Chat, bellen en analyse draaien in één workflow, zonder exports en zonder te wisselen tussen tools. Als je al andere assistent-integraties gebruikt, past de plugin uitstekend naast onze ChatGPT-plugin.

Installeer de plugin vanuit de Dify Marketplace en probeer de flow uit met je eerste assistent. Wil je zien hoe het past bij jouw use case? Boek een demo.