Customer.io
Slå Customer.io-personer, segmenter, kampagner og broadcasts op, og send transactionelle emails eller trig API-broadcasts via MCP.
Overblik
Forbind Customer.io så AI-klienter kan slå personer op, inspicere segmenter, kampagner og broadcasts, og sende transactionelle emails eller trigge API-broadcasts.
Denne integration bruger Customer.io App API. Identifikation af nye personer eller event-tracking (Track API) er endnu ikke inkluderet.
Forudsætninger
- Et Customer.io-workspace med App API-adgang
- Rettighed til at oprette API-credentials (Account Admin eller Member med Manage API Credentials)
- En stackgate.ai-konto
Credentials
- Log ind på Customer.io i det workspace, du vil forbinde.
- Åbn Account Settings → API Credentials.
- Opret en App API Key, giv den et tydeligt navn, og kopiér den med det samme (den vises kun én gang).
- Notér om dit workspace hostes i US- eller EU-datacenteret.
- I stackgate.ai, åbn Mine integrationer → Customer.io.
- Indsæt App API-nøglen, vælg US eller EU, og gem.
- Brug gerne Edit tool access hvis forbindelsen kun skal have Read-værktøjer.
Se Customer.io credentials-dokumentationen og App API-referencen.
Brug med AI-klienter
- Dedikeret endpoint:
POST /mcp/customer-iomed Sanctum bearer token - Private gateway: én config til alle integrationer — brug
customer-io__*-navngivne værktøjer
Se Dokumentation for HTTP-autentificering og opsætning af private gateway.
Fejlfinding
- 422 integration not configured — udfyld credential-formularen i Mine integrationer med App API-nøgle og region.
- 401 Unauthorized — regenerér App API-nøglen i Customer.io og opdater Mine integrationer. Nøgler vises kun én gang ved oprettelse.
- Forkert region / uventede redirects — EU-workspaces skal bruge EU-regionen (
api-eu.customer.io). US-host for et EU-workspace kan sende trafik via US-infrastruktur. - 429 Too many requests — de fleste App API-endpoints tillader ca. 10 requests/sekund. API-triggered broadcasts tillader én trigger hvert 10. sekund.
- Broadcast fejler for manglende personer — broadcasts sendes kun til personer, der allerede findes i workspacet. Tilføj profiler i Customer.io (eller brug Track API identify uden for denne integration) før du triggere.
- Transactionel send afvist — bekræft at
transactional_message_id(eller trigger-navn) findes, og at recipient-identifiers matcher en person eller inkludererto.
Tilgængelige værktøjer
-
get_customers_by_email
Find Customer.io-personer der matcher en e-mailadresse.
-
search_customers
Søg Customer.io-personer med et filter (segmentmedlemskab og/eller attributbetingelser).
-
get_customer_attributes
Hent attributter for en Customer.io-person via customer_id.
-
get_customer_segments
List segmenter som en Customer.io-person tilhører.
-
get_customer_activities
List seneste aktiviteter for en Customer.io-person.
-
get_customer_messages
List beskeder sendt til en Customer.io-person.
-
list_segments
List segmenter i Customer.io-workspacet.
-
get_segment
Hent detaljer for et Customer.io-segment.
-
list_campaigns
List kampagner i Customer.io-workspacet.
-
get_campaign
Hent detaljer for en Customer.io-kampagne.
-
list_broadcasts
List API-triggered broadcasts i Customer.io-workspacet.
-
get_broadcast
Hent detaljer for en Customer.io API-triggered broadcast.
-
list_transactional_messages
List transactionelle beskedskabeloner i Customer.io-workspacet.
-
get_transactional_message
Hent detaljer for en Customer.io transactionel beskedskabelon.
-
send_transactional_email
Send en Customer.io transactionel email.
-
trigger_broadcast
Trig en Customer.io API-broadcast (maks. 1 request hvert 10. sekund).
MCP-endpoint:
https://stackgate.ai/mcp/customer-io
(HTTP) eller via
private gateway.