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.
// 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});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.
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.
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 functielijst11 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// 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// 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" webhookRoute 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// 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-inboxHaal 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// 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// 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// 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// 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// 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// 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 IMAPZodra 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// 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// 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 gebruiksscenarioUw 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.
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.
# Basis-host voor elk verzoekUNIPILE_DSN=jouw-subdomein.unipile.com:POORT# Wordt bij elke aanroep als X-API-KEY-header verzondenUNIPILE_ACCESS_TOKEN=jouw-toegangstokenKoppel 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.
// 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`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.
# 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 !'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.
{ "mcpServers"{ "unifie"{ "url": "https://developer.unipile.com/mcp?branch=v1.0", "Headers"{ "X-API-SLEUTEL": "je-api-sleutel"}
}
}
}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.
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.
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.
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.
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.