Overzicht
Twilio is het toonaangevende cloudcommunicatieplatform, dat API's biedt voor SMS, spraakgesprekken, WhatsApp-berichten, e-mail (via SendGrid), video en de programmeerbare communicatie-infrastructuur die bedrijfsapplicaties gebruiken om te communiceren met klanten en interne teams.
Twilio-integratie is relevant in een breed scala aan bedrijfsapplicatiescenario's. Het e-commerceplatform dat SMS-orderbevestigingen en bezorgingsnotificaties stuurt. Het handelssysteem dat SMS-alerts stuurt wanneer risicogrenzen worden overschreden. De SaaS-applicatie die tweefactorauthenticatiecodes stuurt via SMS. De logistieke systeem dat geautomatiseerde bezorgstatusinformatie-updates stuurt aan ontvangers.
Wij bouwen Twilio-integraties voor bedrijven die hun maatwerk applicaties moeten verbinden met SMS, spraak, WhatsApp en andere communicatiekanalen.
Wat Twilio Integratie Dekt
Twilio-account en authenticatie. Twilio gebruikt Account SID en Auth Token voor API-authenticatie.
Accountcredentials: de Twilio Account SID (een string die begint met AC) en de Auth Token gevonden in de Twilio Console. De credentials gebruikt voor HTTP Basic authenticatie. De Authorization: Basic {base64(accountSid:authToken)} header.
API-sleutels: Twilio API-sleutels als alternatief voor de hoofd Auth Token voor authenticatie. De API-sleutel SID en geheim gebruikt in plaats van de Account SID en Auth Token.
Subaccounts: Twilio subaccounts voor het isoleren van bronnen, facturering en credentials over meerdere applicaties of klanten.
Testcredentials: de Twilio testcredentials die het testen van SMS- en spraakstromen toestaan zonder daadwerkelijk berichten te sturen of kosten te maken.
Programmeerbare SMS. De Twilio SMS API voor het sturen en ontvangen van tekstberichten.
SMS sturen: het POST https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Messages.json eindpunt voor het sturen van een SMS-bericht. De verzoekbody met From, To (het telefoonnummer van de ontvanger in E.164-formaat — +31612345678) en Body. De respons met de bericht SID en status.
Messaging Services: de Twilio Messaging Service SID (begint met MG) als de From waarde — een pool van telefoonnummers met automatische nummerselectie voor optimale bezorgbaarheid.
Lange codes versus korte codes: Twilio lange codes voor laag-tot-medium volume SMS met tweerichtingscommunicatie. Twilio korte codes voor hoog-volume eenrichtingsnotificaties.
SMS tekenlimieten en codering: de 160-tekenlimiet voor een enkel SMS-segment in GSM-7 codering. Berichten langer dan 160 tekens worden gesplitst in meerdelige berichten. Unicode-tekens verkleinen de segmentgrootte tot 70 tekens per segment.
SMS ontvangen: het configureren van de SMS webhook-URL van het Twilio-telefoonnummer — de URL waarnaar Twilio een POST stuurt wanneer een SMS wordt ontvangen. De inkomende berichtpayload met From, To, Body en MessageSid.
Opt-out afhandeling: Twilio handelt automatisch STOP, UNSTOP, HELP sleutelwoorden af voor VS en Canadese nummers.
Twilio Verify — tweefactorauthenticatie. De voorgebouwde verificatie-API voor SMS en telefoon-gebaseerde 2FA.
Verificatieservice aanmaken: de Verify Service aangemaakt via POST https://verify.twilio.com/v2/Services — de service met de vriendelijke naam, de codelengte, de codEvervaldatum en de ingeschakelde kanalen.
Verificatiecode sturen: het POST https://verify.twilio.com/v2/Services/{ServiceSid}/Verifications eindpunt voor het initiëren van een verificatie. Het verzoek met To en Channel (sms, voice, whatsapp).
Code verifiëren: het POST https://verify.twilio.com/v2/Services/{ServiceSid}/VerificationCheck eindpunt. De respons met status (pending of approved).
Programmeerbare Spraak. De Twilio Voice API voor het maken en ontvangen van telefoonoproepen.
Uitgaande oproepen: het POST https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Calls.json eindpunt. Het verzoek met From, To en Url (de TwiML-URL die de oproepstroom definieert).
TwiML voor oproepstromen: de TwiML (Twilio Markup Language) XML die definieert wat er tijdens een oproep gebeurt. De <Say> werkwoord voor tekst-naar-spraak, <Gather> voor het verzamelen van DTMF-tonen, <Record> voor oproepopname, <Dial> voor het verbinden van oproepen.
Inkomende oproepafhandeling: de Voice webhook-URL van het Twilio-telefoonnummer — de URL die Twilio verzoekt wanneer een oproep wordt ontvangen.
Oproepstatuscallbacks: de StatusCallback URL-parameter in het uitgaande oproepverzoek.
WhatsApp Business API via Twilio. WhatsApp-berichten sturen en ontvangen via de WhatsApp Business API-integratie van Twilio.
WhatsApp-ingeschakelde nummers: de Twilio WhatsApp-sandbox voor ontwikkelingstesten en het goedgekeurde WhatsApp Business-profiel voor productiegebruik.
WhatsApp-berichten sturen: hetzelfde POST /Messages.json eindpunt als SMS, met From: whatsapp:+{nummer} en To: whatsapp:+31612345678.
WhatsApp berichtsjablonen: WhatsApp vereist vooraf goedgekeurde berichtsjablonen voor berichten gestuurd buiten het 24-uurs klantenservicevenster.
WhatsApp sessievenster: het 24-uurs venster na het laatste bericht van een klant waarin vrij-formaat berichten kunnen worden gestuurd.
Webhook-verwerking. Twilio-webhooks ontvangen voor inkomende berichten, oproepevenissen en bezorgstatus.
Webhookvalidatie: de X-Twilio-Signature header in elk Twilio-webhookverzoek — de HMAC-SHA1 handtekening. De verplichte handtekeningvalidatie die bevestigt dat het verzoek van Twilio afkomstig is. De validateRequest() methode van de Twilio helper-bibliotheek.
Bezorgstatus webhooks: de StatusCallback URL op uitgaande berichten — de URL waarnaar Twilio POST-verzoeken stuurt met bezorgstatusupdates.
Nummersbeheer. Twilio-telefoonnummers aanschaffen en configureren.
Nummer zoeken en kopen: het GET /AvailablePhoneNumbers/{LandCode}/Local.json eindpunt voor het zoeken naar beschikbare telefoonnummers. Het POST /IncomingPhoneNumbers.json eindpunt voor het kopen van een nummer.
Nederlandse telefoonnummers: Twilio ondersteunt Nederlandse (NL) telefoonnummers — lokale Nederlandse mobiele en geografische nummers.
Twilio SendGrid — transactionele e-mail. De SendGrid e-mail API voor transactionele berichtlevering naast SMS en spraak.
E-mail sturen: het POST https://api.sendgrid.com/v3/mail/send eindpunt. De SendGrid API-sleutel in de Authorization: Bearer {api_sleutel} header.
Dynamische sjablonen: de SendGrid Dynamische Sjablonen die e-mailontwerp scheiden van code — de Handlebars-sjabloon met {{variabele}} plaatshouders en de dynamic_template_data in het stuurverzoek.
Communicatiestroompatronen. Veelgebruikte integratiepatronen voor Twilio-gestuurde communicatie.
Order en bezorgingsnotificaties: de e-commerce integratie die SMS stuurt wanneer een order wordt geplaatst, wanneer het wordt verzonden en wanneer het wordt bezorgd.
Alert en drempelnotificaties: het operationele of handelssysteem dat SMS-alerts stuurt wanneer geconfigureerde condities zijn voldaan.
Tweefactorauthenticatie: de inlogstroom die een Twilio Verify-code stuurt na wachtwoordauthenticatie.
Afspraakherinneringen: de geplande SMS-herinnering gestuurd voor een afspraak.
Gebruikte Technologieën
- C# / ASP.NET Core — Twilio-integratie het
TwilioNuGet-pakket gebruikend - TypeScript / Node.js — Twilio-integratie het
twilionpm-pakket gebruikend - Python — Twilio-integratie het
twilioPyPI-pakket gebruikend - PHP / Laravel — Twilio-integratie het
twilio/sdkComposer-pakket gebruikend - Rust — Twilio REST API-integratie via directe HTTP
- Twilio REST API — SMS, spraak en WhatsApp berichtverzending en -beheer
- Twilio Verify API — telefoonnummerverificatie en tweefactorauthenticatie
- TwiML — oproepstroom en berichtantwoorddefinitie
- Webhooks — inkomend bericht en oproepeventlevering
- HMAC-SHA1 — Twilio webhookhandtekeningvalidatie
- SQL (PostgreSQL / MySQL) — berichtlog, bezorgstatusTracking, opt-outbeheer, verificatierecords
- Redis — webhookdeduplicatie, snelheidslimieten beheer, OTP-status
- Hangfire / geplande taken — geplande afspraakherinneringen, batchnotificatielevering
- Docker — gecontaineriseerde applicatie-implementatie
- GitHub Actions — CI/CD pijplijn voor applicatie-implementatie
Nalevingsoverwegingen voor SMS-communicatie
SMS-communicatie op schaal omvat telecommunicatieregelgeving die per land verschilt.
AVG-naleving: SMS-ontvangers in de EU moeten toestemming hebben gegeven voor marketingcommunicatie. De toestemmingsrecord die documenteert wanneer en hoe de ontvanger zich heeft aangemeld.
Opt-outbeheer: de automatische STOP-afhandeling die Twilio biedt voor VS/Canadese nummers, en het equivalente opt-outmechanisme voor Europese nummers.
Afzender-ID: Nederlandse mobiele carriers ondersteunen alfanumerieke afzender-ID's (tot 11 tekens) voor eenrichtings-SMS. Alfanumerieke afzender-ID's kunnen geen antwoorden ontvangen — voor tweerichtings-SMS is een Twilio-telefoonnummer vereist als afzender.
Multi-Channel Communicatie, Verbonden met Uw Applicaties
Twilio-integraties gebouwd op productiestandaarden — correct Account SID en API-sleutelbeheer, webhookhandtekeningvalidatie voor alle inkomende events, E.164-nummeropmaaK voor betrouwbare levering, berichtsegmentatiebewustzijn voor nauwkeurige kosten- en leveringsvoorspelling, opt-outnaleving voor gereguleerde communicatie en de bezorgstatusmonitoring die fouten oppervlakt voor ze communicatiegaten veroorzaken.