De Complete Unipile API Gids: LinkedIn, Instagram, WhatsApp, E-mail en AI Agents

Unipile API Gids

Eén API om op te bouwen op LinkedIn, Instagram, WhatsApp, e-mail en Uw AI Agent

Unipile geeft uw app, of uw AI-agent, één enkele integratie voor berichten, posts en reacties, e-mail en agenda, via LinkedIn, Instagram, WhatsApp, Telegram, Gmail, Outlook, IMAP, Google Agenda en Outlook Agenda. Eén datamodel, één set endpoints, geen SDK per provider om te onderhouden.

Betalen naar gebruik, vanaf €49/maand, alle functies inbegrepen op elk niveau
reply.js
// Antwoord op elk gekoppeld account, elke provider const formulier = nieuw FormData();formulier.toevoegen("tekst, 'Begrepen, bedankt!');wacht op fetch(`https://${DSN}/api/v1/chats/${chatId}/messages`, { methode: POST, kopteksten: { 'X-API-KEY': TOEGANGSTOKEN }, lichaam: formulier});
200 OK: bericht verzonden
Dezelfde eindpunten, elke provider LinkedIn Instagram WhatsApp Telegram Gmail Outlook IMAP
Gebouwd voor
Solopreneurs & indie hackers SaaS-bouwers Software-editors met een grote gebruikersbasis AI-agentbouwers CRM- en ATS-leveranciers No-code bureaus & automatiseringsstudio's
Productoppervlak

Wat je daadwerkelijk kunt bouwen met Unipile

Unipile is geen berichtengadget die aan één kanaal is vastgeplakt. Het is een volledig API-oppervlak over drie productcategorieën, die elk gemapt zijn aan echte providersintegraties: een account koppelen, een bericht verzenden, een post publiceren, reageren op een opmerking, een inbox synchroniseren of een afspraak boeken. Dit is het complete plaatje.

Kalender
Google AgendaGoogle Agenda Outlook-kalenderOutlook-kalender
Account verbinding3 eindpunten
Kalenderfuncties9 eindpunten
Covers
Lijst kalendersEvenementen makenBijwerken / annulerenDeelnemers

LinkedIn is het diepste oppervlak in de API

34 LinkedIn-specifieke functies verdeeld over 6 categorieën, bovenop de kernberichtlaag: outreach, content, profielen, werving en zoeken.

Outreach11 functies
Stuur InMails InMail-saldo ophalen Outreach-sequenties maken Gebruikers uitnodigen Openstaande uitnodigingen weergeven Verwijder openstaande uitnodigingen Geaccepteerde uitnodigingen detecteren Gebruikers volgen Binnenkomende uitnodigingen weergeven Accepteren / afwijzen uitnodigingen Vaardigheden onderschrijven
Berichten en reacties7 kenmerken
Gebruikers- en bedrijfsberichten weergeven Maak berichten Berichten ophalen Verzend opmerkingen Opmerkingen weergeven Reacties toevoegen Lijst met reacties
Profielen4 functies
Profielen bezoeken & ophalen Contacten en relaties weergeven Bedrijfsprofielen openen Bekijk bezoekers van eigen profiel
Vacature4 functies
Banen aanmaken & publiceren Lijst met banen Verkrijg aanvragers CV's van kandidaten ophalen
Inboxen4 soorten
Klassieke inbox Sales Navigator inbox Recruiter / Recruiter Lite Bedrijfspagina inbox
Zoek op4 scopes
Mensen (Klassiek / Recruiter / Sales Nav) Bedrijven (Klassiek / Sales Nav) Berichten zoeken Vacatures zoeken

Dit is slechts een deel van wat de API blootlegt. Zie de volledige, up-to-date lijst met functies per provider in de ontwikkelaarsdocumentatie.

Bekijk volledige functielijst
Klik om uit te vouwen

11 Dingen die ontwikkelaars daadwerkelijk bouwen met Unipile

Klik op een use case om de juiste endpoints en een werkende code snippet te bekijken. Dit zijn patronen die rechtstreeks voortkomen uit hoe Unipile-klanten de API vandaag de dag gebruiken, geen theoretische voorbeelden.

Een prospect reageert op uw LinkedIn-uitreik. Unipile pusht het nieuwe bericht in realtime naar uw webhook, u toont het in uw eigen inbox-interface en uw vertegenwoordiger reageert zonder ooit LinkedIn te openen.

Gebruikte eindpunten
GET/api/v1/chats/{chat_id}/berichten POST/api/v1/chats/{chat_id}/berichten
reply.js
// Antwoord binnen een bestaand LinkedIn-gesprek const vorm = nieuw FormData(); formulier.toevoegen("tekst, 'Bedankt voor je reactie!');wacht op fetch(`https://${DSN}/api/v1/chats/${chatId}/messages`, methode: POST, headers: { 'X-API-KEY': ACCESS_TOKEN }, lichaam: form // multipart/form-data, geen JSON-header nodig});

Een verkoper vindt een veelbelovende prospect via LinkedIn Search en stuurt rechtstreeks vanuit uw app een connectieverzoek, met een korte gepersonaliseerde notitie in plaats van een blanco uitnodiging. Unipile retourneert een invitation_id die u kunt controleren tegen de lijst met openstaande uitnodigingen, of het moment kunt opvangen waarop het via een webhook wordt omgezet in een geaccepteerde verbinding.

Gebruikte eindpunten
POST/api/v1/users/invite GET/api/v1/users/invite/sent
invite.js
// Stuur een gepersonaliseerde LinkedIn connectieverzoek const uitnodiging = wacht op fetch(`https://${DSN}/api/v1/users/invite`, methode: POST, headers: { 'X-API-KEY'TOEGANGSTOKEN, inhoudstype: "toepassing/json }, lichaam: JSON.stringify({ account_id: accountId, provider_id: prospectProviderId, bericht: 'Genoten van je talk over outbound, zou graag contact leggen.'}) }).dan(r => r.json());// invite.invitation_id: poll GET /users/invite/sent, of luister naar de "new_relation" webhook

Route Instagram DMs van een gekoppeld zakelijk account rechtstreeks naar uw supporttool of CRM. Agenten lezen en reageren vanuit uw eigen interface, Unipile houdt beide kanten van het gesprek synchroon.

Gebruikte eindpunten
GET/api/v1/chats POST/api/v1/chats/{chat_id}/berichten
inbox.js
// Lijst Instagram-gesprekken voor een gekoppeld account const resultaat = wacht op fetch(`https://${DSN}/api/v1/chats?account_id=${igAccountId}`, { headers: { 'X-API-KEY': TOKEN_TOEGANG } });const { items: gesprekken } = wacht op res.json();// gesprekken worden nu rechtstreeks weergegeven in uw CRM-inbox

Haal de reacties op uw Instagram-posts op, reageer publiekelijk vanuit uw dashboard en geef een reactie, zodat uw sociale team nooit meer naar de Instagram-app hoeft te schakelen om de interactie te beheren.

Gebruikte eindpunten
GET/api/v1/posts/{post_id}/comments POST/api/v1/posts/{post_id}/comments
comments.js
// Haal reacties op een bericht op, plaats vervolgens een antwoord const opmerkingen = wacht op fetch(`https://${DSN}/api/v1/posts/${postId}/comments`, { headers: { 'X-API-KEY': ACCESS_TOKEN } }).dan(r => r.json());wacht op fetch(`https://${DSN}/api/v1/posts/${postId}/comments`, methode: POST, headers: { 'X-API-KEY'TOEGANGSTOKEN, inhoudstype: "toepassing/json }, lichaam: JSON.stringify({ tekst: 'Bedankt! Ik stuur je een DM.' }) });

Voer een LinkedIn-zoekopdracht uit naar personen met dezelfde filters als uw team al gebruikt, en haal vervolgens de resultaten rechtstreeks op in uw CRM of een outreach-reeks, één gekoppeld account, geen handmatige export.

Gebruikte eindpunten
POST/api/v1/linkedin/search
search.js
// Voer een LinkedIn-persoonszoekopdracht uit const resultaten = wacht op fetch(`https://${DSN}/api/v1/linkedin/search`, methode: POST, headers: { 'X-API-KEY'TOEGANGSTOKEN, inhoudstype: "toepassing/json }, lichaam: JSON.stringify({ account_id: accountId, categorie: 'mensen', trefwoorden: 'VP Verkoop, Parijs' }) }).dan(r => r.json());

Een bericht plannen vanuit uw eigen contentkalender, de reacties die het genereert ophalen en reageren op betrokkenheid, allemaal zonder dat een mens hoeft in te loggen op LinkedIn om te publiceren.

Gebruikte eindpunten
POST/api/v1/posts GET/api/v1/posts/{id}
publish.js
// Publiceer een LinkedIn-bericht namens een gekoppeld account wacht op fetch(`https://${DSN}/api/v1/posts`, methode: POST, headers: { 'X-API-KEY'TOEGANGSTOKEN, inhoudstype: "toepassing/json }, lichaam: JSON.stringify({ account_id: accountId, tekst: 'We hebben net verzonden...' }) });

Je gesprek eindigt, je app triggert een WhatsApp-bericht met een samenvatting en vervolgstappen, verzonden vanaf hetzelfde nummer waarmee je team al met dat contact chat.

Gebruikte eindpunten
POST/api/v1/chats
followup.js
// Start een nieuw WhatsApp-gesprek met een samenvatting const vorm = nieuw FormData(); formulier.toevoegen('account_id', whatsappAccountId); formulier.toevoegen("tekst, 'Geweldig gesprek vandaag, hier is de samenvatting...'); formulier.toevoegen('deelnemers_ids', contactTelefoonId);wacht op fetch(`https://${DSN}/api/v1/chats`, methode: POST, headers: { 'X-API-KEY': ACCESS_TOKEN }, body: form });

Koppel een Telegram-account en behandel het precies als elke andere inbox: toon chats, ontvang nieuwe berichten direct via webhook en reageer vanuit je eigen tool.

Gebruikte eindpunten
GET/api/v1/chats POST/api/v1/chats/{chat_id}/berichten
telegram.js
// Telegram-chats weergeven voor een gekoppeld account const chats = wacht op fetch(`https://${DSN}/api/v1/chats?account_id=${tgAccountId}`, { headers: { 'X-API-KEY': ACCESS_TOKEN } }).dan(r => r.json());

Integreer een mailbox in je product met behoud van threads, ongeacht welke van de 3 providers je gebruiker verbindt: Gmail, Outlook of IMAP. Eén datamodel, geen aparte Gmail vs. Outlook-logica in je app.

Gebruikte eindpunten
GET/api/v1/mails POST/api/v1/mails
inbox-synchronisatie.js
// Haal de laatste e-mails op voor een gekoppelde mailbox, geordend op conversatie const Postvak in = wacht op fetch(`https://${DSN}/api/v1/mails?account_id=${mailboxId}`, { headers: { 'X-API-KEY': ACCESS_TOKEN } }).dan(r => r.json());// Dezelfde vorm, ongeacht of mailboxId wijst naar Gmail, Outlook of IMAP

Zodra een potentiële klant akkoord gaat met een gesprek binnen een LinkedIn- of e-mailthread, controleer je de beschikbaarheid en maak je de afspraak aan in hun Google- of Outlook-agenda, zonder je app te verlaten.

Gebruikte eindpunten
GET/api/v1/kalenders/{id}/evenementen POST/api/v1/kalenders/{id}/evenementen
boek.js
// Maak een agenda-afspraak aan zodra een vergadering is bevestigd wacht op fetch(`https://${DSN}/api/v1/calendars/${calendarId}/events`, methode: POST, headers: { 'X-API-KEY'TOEGANGSTOKEN, inhoudstype: "toepassing/json }, lichaam: JSON.stringify( titel: 'kennismakingsgesprek', start_time: startISO, end_time: endISO, attendees: [email] }) });

In plaats van te pollen, abonneer je één keer en ontvang je een webhook op het moment dat er een nieuw bericht, een nieuwe e-mail of een wijziging in de accountstatus plaatsvindt, via elke gekoppelde provider.

Gebruikte eindpunten
POST/api/v1/webhooks
webhook.js
// Abonneer je op nieuwe-bericht-gebeurtenissen voor alle gekoppelde accounts wacht op fetch(`https://${DSN}/api/v1/webhooks`, methode: POST, headers: { 'X-API-KEY'TOEGANGSTOKEN, inhoudstype: "toepassing/json }, lichaam: JSON.stringify{ bron: 'Berichtenuitwisseling', gebeurtenis: 'bericht_ontvangen', verzoek_url: 'https://jouwapp.com/webhooks/unipile' }) });

Dit zijn slechts 11 patronen. Dezelfde eindpunten combineren tot wat uw app of AI-agent ook moet doen.

Begin met het bouwen van uw eigen gebruiksscenario
Snelstart

Uw eerste API-oproep, in drie stappen

Haal je inloggegevens op, koppel een gebruikersaccount, stuur je eerste bericht. Hier is precies hoe, met de redenatie achter elke oproep, niet alleen de code.

01

Ontvang uw DSN en toegangstoken

Meld je aan bij dashboard.unipile.com/aanmelden. Jouw DSN (Gegevensbronnaam) is de host van uw toegewijde Unipile-instantie, het komt in elke request URL. Uw Toegangssleutel, gegenereerd uit de pagina met toegangstokens, verifieert elke oproep als de X-API-KEY kop.

De DSN is uniek voor uw account, geen gedeelde API-URL.
Bewaar de toegangstoken aan de serverzijde, nooit in clientcode.
.env
# Basis-host voor elk verzoekUNIPILE_DSN=jouw-subdomein.unipile.com:POORT# Wordt bij elke aanroep als X-API-KEY-header verzondenUNIPILE_ACCESS_TOKEN=jouw-toegangstoken
02

Koppel een gebruikersaccount aan Hosted Auth

Eén telefoontje naar POST /api/v1/hosted/accounts/link geeft een link terug. Stuurt de gebruiker ernaartoe, Unipile voert de eigen inlogflow van de provider uit (QR-code, OAuth of inloggegevens, afhankelijk van de provider), en post vervolgens de nieuwe account_id naar jou notify_url, passend bij de naam u stuurde.

link-account.js
// Genereer een gehoste authenticatielink voor LinkedIn, Instagram, WhatsApp const resultaat = wacht op fetch(`https://${DSN}/api/v1/hosted/accounts/link`, methode: POST, headers: { 'X-API-KEY'TOEGANGSTOKEN, inhoudstype: "toepassing/json }, lichaam: JSON.stringify({ type: 'creëren', providers: ['LINKEDIN', 'INSTAGRAM', 'WHATSAPP'], api_url: `https://${DSN}`,verlooptOp: '2026-12-31T00:00:00.000Z', success_redirect_url: 'https://jouwapp.com/connected', notify_url: 'https://jouwapp.com/webhooks/unipile', naam: internalUserId // je eigen gebruikers-id, teruggestuurd in de webhook}) });const { url } = wacht op res.json();// leid de gebruiker om naar `url`
03

Stuur uw eerste bericht

Zodra de account is gekoppeld, pak een chat_id van GET /api/v1/chats en verzenden. Het lichaam is multipart/formulier-data omdat bijlagen (tot 15MB) mee kunnen liften in dezelfde oproep, geen aparte uploadstap.

eerste-oproep.sh
# Een sms-bericht versturen naar een bestaand gesprekcurl --request POST \ --url https://{DSN}/api/v1/chats/{chat_id}/messages \ --header 'X-API-KEY: {TOEGANGSTOKEN}' --hoofd accepteer: toepassing/json --hoofd inhoudstype: multipart/formulier-data --formulier 'Hallo wereld !'
Nieuw: MCP Server

Verbind uw AI met MCP

Uw codeeragent hoeft niet te raden hoe de Unipile API werkt. Wijs Claude Desktop, Cursor of Windsurf naar de Unipile MCP-server en deze krijgt directe, geauthenticeerde toegang tot de API, plus de documentatie, zodat deze integratiecode kan schrijven en testen tegen uw echte gekoppelde accounts.

Wat is MCP?

Het Model Context Protocol is een open standaard waarmee AI-applicaties veilig toegang hebben tot externe gegevensbronnen en tools. De Unipile MCP-server biedt uw AI-ontwikkelomgeving directe connectiviteit met de bericht-, e-mail- en agenda-API's van Unipile, zonder dat handmatig documenten hoeven te worden opgezocht.

CD
Claude DesktopVoeg de server toe in Instellingen > Ontwikkelaar
Tot ziens
CursorVoeg de server toe in MCP-instellingen
WS
WindsurfenVoeg de server toe in de MCP-configuratie
Directe API-toegang tot Unipile-functionaliteit vanuit uw IDE
Documentatie zoeken ingebouwd in het gesprek, geen tabbladen wisselen
Codegeneratie voor echte integraties, getest met uw eigen gekoppelde accounts
mcp.json
{ "mcpServers"{ "unifie"{ "url": "https://developer.unipile.com/mcp?branch=v1.0", "Headers"{ "X-API-SLEUTEL": "je-api-sleutel"} } } }
Verantwoord Gebruik

Verantwoord Gebruik & Naleving

Voordat u gaat bouwen, is het nuttig om precies te begrijpen hoe Unipile met gegevens omgaat en waar de verantwoordelijkheden liggen. Hier is de korte versie.

GDPR-compliant SOC 2-compatibel
01 · Gegevens

Gegevensverwerking Opmerking

Unipile onderhoudt geen onafhankelijke datawarehouse van de berichten, e-mails of contacten van uw gebruikers. Elk verzoek haalt gegevens op via de API namens het geauthenticeerde, gekoppelde account, beperkt tot die sessie. Er is geen parallel archief en geen bulkexport buiten wat de gekoppelde gebruiker al toegang heeft.

02 · Operatie

Hoe Unipile Werkt

Unipile fungeert als een onafhankelijke technische intermediair, geen partner van LinkedIn, Meta, Microsoft, Google of Telegram. Elke actie vindt plaats namens de geauthenticeerde gebruiker die zijn account heeft gekoppeld, met behulp van de inloggegevens en sessie van die gebruiker. Unipile deelt nooit inloggegevens tussen klanten.

03 · Limieten

Platformlimieten en verantwoord gebruik

Unipile geeft de snelheidslimieten en gebruiksbeperkingen van elk onderliggend platform door, het verwijdert deze niet. Hoe snel u berichten verzendt, hoeveel accounts u koppelt en hoe u de opgehaalde gegevens gebruikt, blijft een beslissing van de klant, beheerst door de voorwaarden van elke provider en door GDPR- en SOC 2-vereisten voor het opslaan van die gegevens.

Unipile is niet gelieerd aan, goedgekeurd door of gesponsord door LinkedIn, Meta, Microsoft, Google of Telegram. Alle productnamen, logo's en merken die in deze gids worden genoemd, zijn eigendom van hun respectieve eigenaren.

Unipile API Gids - FAQ

De vragen die ontwikkelaars het meest stellen vóór hun eerste integratie.

Unipile biedt één integratie om berichten te verzenden en ontvangen op LinkedIn, WhatsApp, Instagram en Telegram, posts en reacties te publiceren en beheren, profielen op te halen, Gmail-, Outlook- of IMAP-postbussen te synchroniseren met volledige threading, en Google Agenda- en Outlook Agenda-afspraken te lezen of aan te maken. Het is een enkele set endpoints en een enkel gegevensmodel voor elke gekoppelde account, geen aparte SDK per provider.

Instagram is een eersteklas provider in Unipile. Naast directe berichten kun je reacties op posts ophalen en beantwoorden, reageren op content, en profiel- en engagementgegevens ophalen, dezelfde categorieën als beschikbaar voor LinkedIn, via de Social & Messaging API.

De Unipile MCP serverhttps://developer.unipile.com/mcp?branch=v1.0) laat AI-ontwikkeltools zoals Claude Desktop, Cursor en Windsurf rechtstreeks verbinding maken met de Unipile API met behulp van uw toegangstoken. Uw codeeragent kan vervolgens de documentatie bevragen en de API aanroepen om u te helpen bij het bouwen en testen van een integratie, in plaats van dat u de documentatie naar een chatvenster kopieert en plakt.

Elke aanvraag heeft twee dingen van uw nodig Dashboard Unipile: uw DSN, wat de basis host is voor uw verzoeken, en een Toegangstoken, verzonden als de X-API-KEY header. Je genereert beide vanuit het API-dashboard en de pagina met toegangstokens.

Het snelste pad is Hosted Auth: één enkele aanroep naar POST /api/v1/hosted/accounts/link geeft een link terug waar je de gebruiker naartoe doorstuurt. Unipile regelt de eigen inlogstroom van de provider (QR-code, OAuth of inloggegevens, afhankelijk van de provider) en informeert jouw webhook met de nieuwe account_id zodra de account is gekoppeld.

Drie: Gmail, Outlook (wat ook Microsoft 365 en Exchange Online omvat), en IMAP als universele fallback voor elke andere mailprovider. Alle drie delen hetzelfde threading-model en dezelfde set van endpoints.

Nee. Chats, berichten en bijlagen gebruiken dezelfde eindpunten voor LinkedIn, WhatsApp, Instagram en Telegram. Je filtert op account_id Om een specifiek gekoppeld account en provider te targeten, verandert de request shape niet.

Unipile opereert als een onafhankelijke technische tussenpersoon en onderhoudt geen parallelle datawarehouse, elke aanvraag haalt gegevens op namens het geauthenticeerde gekoppelde account. Unipile is GDPR-compliant en SOC 2-compatibel; hoe u de gegevens die u ophaalt opslaat en gebruikt, blijft uw verantwoordelijkheid als verwerkingsverantwoordelijke.

Prijzen zijn pay-as-you-go, beginnend bij €49/maand voor maximaal 10 gekoppelde accounts, daarna wordt het per account berekend. Elke functie die in deze gids wordt beschreven, berichten, posts, e-mail, agenda, MCP, is inbegrepen op elk niveau, er is geen functiesperking. Zie de volledige analyse op de Prijzen.

Heb je nog vragen? Ons team staat klaar om te helpen.

Praat met een expert

Begin met Bouwen met Unipile

Koppel uw eerste account binnen enkele minuten en verzend vandaag nog uw eerste bericht, post, e-mailsynchronisatie of agenda-afspraak.

Betalen per gebruik, vanaf €49/maand. Elke functie is inbegrepen op elk niveau.

nl_NLNL