Unipile MCP · Webhooks

LinkedIn-, WhatsApp- en e-mailwebhooks koppelen met een coding agent

Q: Hoe maak ik een webhook-endpoint aan?

POST https://api.unipile.com/v2/webhooks/endpoints/ met de X-API-KEY-header en een body met trigger_events en url. De response bevat een id in we_… en een secret.

Q: Hoe beperk ik een webhook tot de accounts van één klant?

Met account_ids, een array van identifiers in acc_…. Weggelaten of leeg luistert het endpoint naar elk account van de applicatie.

Q: Hoe verifieer ik dat een notificatie echt is?

Het aanmaken van het endpoint geeft een secret terug. Bewaar het server-side en valideer elke levering voordat u die verwerkt. Uw URL moet HTTPS zijn en publiek bereikbaar; de afleverlog is beschikbaar via de webhook conversations-route.

LinkedIn heeft geen openbare webhook voor de berichten van een lid. Unipile pusht ze naar uw endpoint, en met de Unipile MCP-server schrijft uw agent de handler.

Webhooks koppelen met een agent Webhooks-docs

7 dagen gratis proberen, geen creditcard nodig.

Abonneer op webhooks voor nieuwe berichten en werk de tijdlijn van het contact bij.

Request uitvoerenPOST /v2/webhooks/endpoints/201 · we_…

Endpoint aangemaakt op de Development-app, plus een idempotente handler met queue.

3 bestanden gewijzigd · eerste event binnen een seconde ontvangen

Beschrijf de volgende feature…

De taak

Wat u wilt bereiken

Toon een nieuw bericht of een nieuwe e-mail in uw product zodra die binnenkomt, en reageer wanneer een account wordt ontkoppeld, zonder polling. LinkedIn heeft geen openbare berichtenwebhook voor een ledenaccount; Unipile pusht hetzelfde event voor elk kanaal.

Nieuw LinkedIn-berichtop het account dat uw gebruiker heeft gekoppeld

Nieuw WhatsApp-berichtzelfde event, ander kanaal

Nieuwe e-mailGmail, Outlook of IMAP

message.newmessage.newemail.new

Uw app · contacttijdlijnPOST /webhooks/unipile

Sarah K. antwoordde op LinkedIn0.4 s

Tom R. stuurde een WhatsApp-bericht0.3 s

Ana L. mailde het voorstel0.5 s

In een queue, ontdubbeld, één keer geschreven

Zonder Pollinglussen en blinde vlekken

Een job die elk account elke dertig seconden pollt, meestal voor niets.

Helemaal geen LinkedIn-berichtevent, omdat het platform er geen aanbiedt voor een ledenaccount.

Een ontkoppeld account dat de gebruiker ontdekt, niet uw product.

Met de Unipile MCP-server Het resultaat in uw applicatie

Een webhook-endpoint met een abonnement op de events die u verwerkt, aangemaakt op uw Development-applicatie.

Een handler die direct antwoordt, vanuit een queue verwerkt en elk event één keer schrijft.

Een contacttijdlijn en een accountstatus die binnen een seconde worden bijgewerkt, getest voordat u live gaat.

Prompt, stappen, code

Geef uw agent de prompt

Twee prompts, elk met de Unipile-endpoints die de agent leest en aanroept en wat er in uw project terechtkomt. Paden zijn volledig, op de API-basis-URL https://api.unipile.com, met uw scoped sleutel in de X-API-KEY header.

Uw agent · crm-appDevelopment-app

Abonneer op webhooks van Unipile voor nieuwe berichten en werk de tijdlijn van het contact bij: maak het webhook-endpoint aan voor message.new en email.new, voeg een idempotente handler toe in deze applicatie en zet de verwerking in een queue.

Endpoint lezenPOST /v2/webhooks/endpoints/schema geladen

Request uitvoerenPOST /v2/webhooks/endpoints/201 · we_… + secret

Endpoint aangemaakt met trigger_events: ["message.new", "email.new"] en de publieke URL van de app, de geretourneerde secret server-side opgeslagen, toegevoegd: POST /webhooks/unipile dat de levering valideert, direct 200 antwoordt en de payload in de queue zet, plus een worker die ontdubbelt op de object-ID voordat hij naar de contacttijdlijn schrijft. Testbericht verstuurd op de Development-app: tijdlijn bijgewerkt.3 bestanden gewijzigd · queue, idempotent, geverifieerd

Eerst bevestigen, later verwerken, één keer schrijven

De agent leest het endpointcontract via de server: trigger_events en url zijn verplicht, account_ids beperkt de scope, en de response bevat de endpoint-ID en het secret. Daarna schrijft hij de handler zoals een webhook dat vraagt: directe 2xx, asynchrone verwerking, ontdubbeling op de objectidentifier, en een controle van de afleverlog als er iets lijkt te ontbreken.

Endpoints die de agent gebruikt

POST/v2/webhooks/endpoints/GET/v2/webhooks/endpoints/GET/v2/webhooks/conversations/GET/v2/{account_id}/chats/{chat_id}/messages/{message_id}

Veelgemaakte fout: Het werk binnen de handler doen. Antwoord direct met 2xx en verwerk het event vanuit een queue, anders lopen leveringen in een timeout en worden ze opnieuw geprobeerd.

Voed een unified inbox met deze events

Uw agent · crm-appDevelopment-app

Verwerk webhooks voor de levenscyclus van accounts: markeer bij account.status.disconnected het account als aandachtspunt en toon een Reconnect-knop, en sla bij account.add de nieuwe account_id op bij de workspace uit state.

Endpoint lezenPOST /v2/webhooks/endpoints/event enum

Request uitvoerenPATCH /v2/webhooks/endpoints/{id}200 · events bijgewerkt

Toegevoegd: account.add, account.reconnect en account.status.disconnected aan het endpoint. Bij account.add slaat de worker de account_id op bij de workspace uit state; bij account.status.disconnected markeert hij het account en toont de Settings-pagina de Reconnect-knop die de reconnect-route van Hosted Auth aanroept. Geverifieerd door het mock-account op de Development-app te ontkoppelen.2 bestanden gewijzigd · reconnect zichtbaar in de UI

De account-events sluiten de cirkel met Hosted Auth

account.add en account.reconnect bevatten de state die u instelde bij het aanmaken van de auth-link, waardoor de webhook de bron van waarheid is voor een nieuwe koppeling. De status-events laten uw product weten wanneer een account aandacht nodig heeft, nog voordat de gebruiker het merkt. De agent koppelt beide aan hetzelfde endpoint en houdt de handler idempotent.

Endpoints die de agent gebruikt

PATCH/v2/webhooks/endpoints/{id}GET/v2/accounts/{account_id}POST/v2/auth/link

Veelgemaakte fout: Op alles abonneren. Er bestaan negenendertig events; een endpoint dat op alle events is geabonneerd, ontvangt non-stop leesbevestigingen en tracking-opens. Abonneer op wat u verwerkt.

De reconnect-flow implementeren met een agent

Payload

De endpoint body, de response en de events

Letterlijk uit het v2-contract dat de agent via de server leest. Twee velden zijn verplicht, de response bevat het secret, en de events zijn in families ingedeeld.

1Het endpoint aanmakentrigger_events en url zijn verplicht. account_ids beperkt het endpoint tot bepaalde accounts; leeg of weggelaten luistert het naar elk account van de applicatie.POST https://api.unipile.com/v2/webhooks/endpoints/ { "trigger_events": ["message.new", "email.new", "account.add"], "url": "https://app.example.com/webhooks/unipile", "account_ids": ["acc_…"], "description": "crm timeline" }

2De responseEen WebhookEndpoint met zijn id, de applicatie, het secret dat u server-side bewaart, en de accounts waarop het zich richt.{ "object": "WebhookEndpoint", "id": "we_…", "application_id": "app_…", "enabled": true, "secret": "…", "trigger_events": [ … ], "account_targets": [ … ] }

3De events, per familieAccount (status, add, reconnect, remove, sync), message (new, update, delete, receipts, reactions), chat, e-mail (new, bounce, delete, drafts, folders), calendar (create, update, delete, event.*), tracking en relations.message.new · message.update · message.receipt.read · chat.update email.new · email.new.bounce · email.draft.new · email.folder.update account.add · account.reconnect · account.status.disconnected · account.initial_sync.completed

Van Development naar productie

Test eerst op een Development-applicatie

Uw Unipile-dashboard scheidt een Development-applicatie van Production. Geef de agent een scoped sleutel uit Development, één testaccount en een tunnel-URL: echte events, geen echte klant.

1Maak het endpoint aan op de Development-appTunnel-URL, trigger_events beperkt tot wat u verwerkt.

2Ontvang één event van begin tot eindaccount.add vanuit een mock Hosted Auth-link, daarna message.new vanaf het testaccount.

3Speel het opnieuw af en zet dan de sleutel omDe worker schrijft één keer; account_ids beperkt tot de juiste klant vóór Production.

crm-app · DevelopmentGebruikt door uw agent

Scopedev-tests · 2 accounts

Sleutelscoped Account API-sleutel

AccountsLinkedIn-testaccount, Gmail-testmailbox

Webhooks1 endpoint · berichtevents

crm-app · ProductionOnaangeroerd

Scopeéén per workspace

Sleutelscoped sleutels, alleen in uw backend

Accountsde eigen accounts van uw gebruikers, via Hosted Auth

Probleemoplossing

Veelvoorkomende fouten en wat ze betekenen

De vier fouten die webhooks onbetrouwbaar maken, en de oplossing voor elk. Geen ervan gaat over de events zelf.

Het endpoint antwoordt traag

Leveringen lopen in een timeout en stapelen zich op als retries. OplossingAntwoord direct met 2xx en verwerk vanuit een queue. Een handler die naar de database schrijft voordat hij antwoordt, eindigt met het opnieuw afspelen van zijn eigen achterstand.

Een handler die niet idempotent is

Hetzelfde bericht verschijnt twee keer in de tijdlijn. OplossingHetzelfde event kan meer dan eens worden afgeleverd. Ontdubbel op de objectidentifier uit de payload voordat u schrijft.

Op alles geabonneerd

Het endpoint ontvangt non-stop leesbevestigingen en tracking-opens. Oplossingtrigger_events accepteert negenendertig waarden. Abonneer op de events die u verwerkt, en maak meerdere endpoints aan als de verwerking verschilt.

account_ids vergeten in een product met meerdere klanten

De worker van de ene klant ontvangt de events van een andere klant. OplossingLeeg of weggelaten luistert account_ids naar elk account van de applicatie. Beperk het expliciet per klant, of filter op het account in de payload voordat u schrijft.

6000+ Bedrijven innoveren met Unipile

Vertrouwd door marktleiders

1 API

Activiteiten stroomlijnen voor alle belangrijke communicatiekanalen

2 dagen

Snel live integratie bereiken met minimale installatie

30%

Vermindering van onderhoudsinspanningen en -middelen

Ingebouwde beveiliging en compliance

Enterprise-bescherming voor uw gegevens en workflows Meer informatie over onze beveiliging

SOC 2 type II

Gecertificeerd

Onafhankelijk gecontroleerde beveiligingscontroles voor gegevensbescherming en operationele integriteit.

GDPR

Conform

Volledige naleving van de Europese regelgeving voor gegevensbescherming voor de privacy van gebruikers.

99.9%

Platform Uptime over de laatste 24 maanden

24/7

Wereldwijde ondersteuning met krachtige API

FAQ over webhooks

Of LinkedIn een berichtenwebhook heeft, hoe u een endpoint aanmaakt, welke events er zijn, hoe u een endpoint tot één klant beperkt en hoe u een levering verifieert.

Niet voor een ledenaccount. De openbare webhooks van LinkedIn dekken sociale acties van organisaties en leadformulieren; berichten van leden zitten achter een complianceprogramma dat geen nieuwe partners meer aanneemt. Met Unipile dekt het message.new event LinkedIn net als elk ander kanaal, op het account dat uw gebruiker zelf heeft gekoppeld.

POST https://api.unipile.com/v2/webhooks/endpoints/ met de X-API-KEY header en een body met trigger_events en url. De response bevat een id in we_… en een secret.

Negenendertig waarden verdeeld over de families account, message, chat, e-mail, calendar, tracking en relation. De meest gebruikte zijn message.new, email.new, account.add, account.reconnect en account.status.disconnected.

Met account_ids, een array van identifiers in acc_…. Weggelaten of leeg luistert het endpoint naar elk account van de applicatie.

Het aanmaken van het endpoint geeft een secret terug. Bewaar het server-side en valideer elke levering voordat u die verwerkt. Uw URL moet HTTPS zijn en publiek bereikbaar; de afleverlog is beschikbaar via de webhook conversations-route.