stackgate.ai
Alle integrationer

Twilio

Læs Twilio SMS- og voice-leveringsstatus, søg i beskeder og list indgående numre via MCP.

Manual setup 6 værktøjer

Eksempelspørgsmål

Prøv at spørge din AI-klient

  • Which Twilio messages failed in the last 2 days?

  • Did the SMS to Jack about the outage ever get delivered?

  • Summarize delivery errors from the last hour without showing full numbers.

  • Write a short incident note for Slack - do not send a new SMS.

  • Which incoming numbers received traffic this week?

Overblik

Forbind Twilio, så AI-klienter kan læse SMS- og voice-leveringsstatus, søge i beskeder og liste indgående numre via Twilio REST API.

Integrationen er read-first. Afsendelse af SMS eller opkald er ikke inkluderet. Brug den til at bekræfte om et alert, OTP eller onboarding-besked blev leveret.

Forudsætninger

  • En Twilio-konto
  • Account SID og Auth Token fra Account Dashboard, eller et API Key SID og secret (eller en parent-konto der kan læse en subaccount)
  • En stackgate.ai-konto

Sådan får du credentials

  1. Log ind i Twilio Console.
  2. Åbn Account Dashboard. Kopiér Account SID (starter med AC) og Auth Token. Alternativt: åbn Account → API keys & tokens, opret en nøgle, og kopiér API Key SID (starter med SK) plus dens secret.
  3. Valgfrit: for at begrænse læsning til en subaccount, åbn Account → Subaccounts og kopiér det SID.
  4. I stackgate.ai: Mine integrationer → Twilio.
  5. Indsæt Account SID og Auth Token, eller API Key SID og secret. Tilføj kun subaccount SID, hvis værktøjerne som standard skal slå op i den subaccount.
  6. Gem. stackgate.ai verificerer credentials mod Twilio og gemmer hemmeligheder krypteret. API-nøgler slås automatisk op til Account SID.
  7. Brug evt. Edit tool access for kun at tillade læseværktøjer.

Se Twilio REST API og Messages-ressourcen.

Credentials-reference

Felt Påkrævet Hvor finder du det Noter
Account SID eller API Key SID Ja Console Account Dashboard eller API-nøgler Account SID starter med AC. API Key SID starter med SK.
Auth Token eller API Key secret Ja Console Account Dashboard eller API-nøgler Rotér hvis lækket; gemmes krypteret
Subaccount SID Nej Account → Subaccounts Parent-credentials skal kunne læse dette SID

Rettigheder

Rettighed Hvorfor Adgang
Account SID + Auth Token Autentificér REST-læsning af beskeder, opkald og numre Læs

Twilio bruger ikke OAuth i denne connect-flow. Auth Token kan læse alle ressourcer kontoen ejer. Foretræk en dedikeret subaccount til agentadgang når det er muligt.

Brug med AI-klienter

  • Dedikeret endpoint: POST /mcp/twilio med Sanctum bearer token
  • Private gateway: én config til alle integrationer - brug twilio__*-navngivne værktøjer

Eksempel-prompter:

  • "List mine seneste Twilio-beskeder og deres leveringsstatus."
  • "Søg efter Twilio-beskeder sendt til +15551234567 i dag."
  • "Hent Twilio-besked SM123 og fortæl om den fejlede."
  • "List indgående Twilio-telefonnumre."

Fejlfinding

Problem Sandsynlig årsag Løsning
422 integration not configured Formularen er ikke gemt Udfyld Account SID og Auth Token under Mine integrationer
401 Unauthorized Forkert SID eller roteret token Kopiér det aktuelle Auth Token fra Console og opret forbindelsen igen
Ugyldigt Account SID-format SID mangler AC- eller SK-præfiks Indsæt Account SID fra Account Dashboard, eller et API Key SID fra API-nøgler
404 på besked eller opkald Forkert SID eller forkert konto/subaccount Tjek SID og valgfri subaccount
429 Too many requests Twilios burst- eller concurrent-grænser Prøv igen efter kort pause og hold page_size lav

Sikkerhed og tilbagekaldelse

  • Afbryd Twilio under Mine integrationer for at slette gemt SID og token fra stackgate.ai.
  • Rotér Auth Token i Twilio Console, hvis du mistænker lækage.
  • Telefonnumre og beskedtekst i værktøjsresultater er PII. Foretræk SID og status i Slack- eller ticket-opsummeringer.
  • Audit logs registrerer værktøjsnavne og argumenter. Undgå at indsætte rå numre i offentlige prompts, når et SID er nok.
  • stackgate.ai krypterer credentials at rest og gemmer ikke beskedtekst, medmindre du kopierer den til Temp Storage.

Begrænsninger

  • Read-only MVP: ingen send SMS, ingen udgående opkald, ingen webhook-styring.
  • Regionale numre og sender-ID følger din Twilio-konto og landeregler.
  • Datofiltre bruger kontoens tidszone (DateSent som YYYY-MM-DD).
  • List-værktøjer bruger små sider for at begrænse PII i model-kontekst.

Tilgængelige værktøjer

  • list_messages

    List seneste Twilio SMS/MMS med leveringsstatus.

  • get_message

    Hent en Twilio-besked efter SID, inkl. status og fejl-kode.

  • search_messages

    Søg Twilio-beskeder efter nummer og/eller afsendelsesdato.

  • list_calls

    List seneste Twilio-opkald med status.

  • get_call

    Hent et Twilio-opkald efter SID.

  • list_phone_numbers

    List indgående Twilio-telefonnumre på kontoen.

MCP-endpoint: https://stackgate.ai/mcp/twilio (HTTP) eller via private gateway.

Relaterede workflows

Multi-integrations-playbooks, der bruger Twilio til konkrete forretningsresultater.

Opret konto Dokumentation