Sms en WhatsApp versturen met je eigen Twilio-account
Koppel Twilio om enquête-uitnodigingen per sms en WhatsApp vanaf je eigen nummers te versturen, antwoorden in Gesprekken te ontvangen en de afleverstatus van elk bericht te zien.
Op deze pagina
Koppel je Twilio-account en Polzy verstuurt de sms- en WhatsApp-berichten van deze werkruimte — uitnodigingen en herinneringen van campagnes, workflowberichten en antwoorden in een gesprek — vanaf je eigen Twilio-nummers. Mensen kunnen terug-sms'en: antwoorden komen binnen in het gesprek in Polzy, en het logboek van elk bericht toont of het is afgeleverd.
Sms en WhatsApp zitten in Business en hoger, en alleen Beheerders kunnen een provider koppelen. Koppel Twilio op de pagina Integraties, of onder Berichten → Integraties.
Voordat je begint
Je hebt nodig:
- Een werkruimte in Business of hoger, en de rol Beheerder daarin.
- Een geüpgraded Twilio-account (geen proefaccount), met een nummer dat sms kan versturen, of een Messaging Service.
- Voor WhatsApp: een WhatsApp-afzender die in Twilio is geregistreerd (zie WhatsApp).
- De mobiele nummers van je deelnemers in hun gegevens. Polzy bewaart ze in internationale notatie, zoals
+31 6 1234 5678; een nummer zonder landcode wordt gelezen in het land van je organisatie, dat uit Factuurgegevens.
Hoe Polzy Twilio gebruikt
- Sms en WhatsApp. Zodra je Twilio kiest voor sms, WhatsApp of beide, gaat elk bericht dat de werkruimte op dat kanaal verstuurt via je account.
- Antwoorden. Sms't iemand terug, dan wordt het antwoord toegevoegd aan diens open gesprek in Polzy (zie Gesprekken).
- Aflevering. Het logboek van elk bericht in Berichten toont Afgeleverd of Mislukt, met de reden van Twilio.
- Wat het kost. Twilio brengt je deze berichten in rekening. Ze tellen niet mee voor de maandelijkse berichten van je organisatie in Polzy; die gelden alleen voor de eigen afzender van Polzy.
Stap 1: Twilio instellen
- Koop in de Twilio Console een nummer dat sms kan versturen naar de landen die je nodig hebt, of maak onder Messaging → Services een Messaging Service aan en voeg je nummers toe aan de sender pool. Een Messaging Service kiest voor elk bericht het juiste nummer.
- Kopieer je Account SID en Auth Token uit Account Info op de startpagina van de Console.
- Verstuur je naar andere landen, controleer dan dat die zijn toegestaan in de geografische sms-rechten (geo permissions) van je account.
Zie Twilio: Messaging Services.
Stap 2: Twilio koppelen in Polzy
- Open Integraties in de zijbalk, het tabblad Beschikbaar, en klik op Verbinden in de rij van Twilio. Of open Berichten, het tabblad Integraties, en klik op Instellen bij Twilio.
- Vul in het paneel Twilio koppelen de velden in:
| Veld | Wat je invult |
|---|---|
| Account SID | Begint met AC. Verplicht. |
| Auth Token | Verplicht. Polzy gebruikt hem ook om te controleren dat afleverbevestigingen en antwoorden van Twilio komen. |
| Messaging Service SID | Begint met MG. Aanbevolen voor sms. |
| Afzendertelefoonnummer | Een Twilio-nummer in internationale notatie, als je geen Messaging Service gebruikt. |
| WhatsApp-afzendernummer | Het nummer van je WhatsApp-afzender, zoals +15550000000, voor WhatsApp. |
Vul een Messaging Service SID of een Afzendertelefoonnummer in: Polzy heeft er één van nodig, ook als je alleen WhatsApp verstuurt. Staan beide ingevuld, dan wordt voor sms de Messaging Service gebruikt.
- Klik op Verbinding testen. Je ziet Connected to Twilio account: gevolgd door de naam van je account (deze melding is in het Engels).
- Klik op Verbinden.
Stap 3: Twilio kiezen voor sms en WhatsApp
- Open Instellingen, dan het tabblad Meldingen, en scrol naar Kanalen.
- Wijzig in de rij SMS Polzy · gedeeld account in Twilio, en controleer dat de schakelaar aan staat.
- Wil je ook WhatsApp versturen, doe dan hetzelfde in de rij WhatsApp.
Slack
TeamsEen campagne verstuurt dan via Twilio wanneer je op het tabblad Verzending SMS of WhatsApp als kanaal kiest. Een campagne gebruikt één kanaal.
Stap 4: Antwoorden ontvangen
Afleverbevestigingen hebben verder niets nodig: Polzy vraagt Twilio bij elk verstuurd bericht om een status callback. Voor antwoorden is één instelling in Twilio nodig.
- Open in Polzy de pagina van Twilio vanuit Integraties en zoek Ontvangen. Kopieer het adres dat daar staat.
- Open in de Twilio Console de berichtinstellingen van je nummer en stel de webhook voor inkomende berichten ("a message comes in") in op dat adres, met de methode HTTP POST. Gebruik je een Messaging Service, stel hem dan in bij de integratie-instellingen van de service. Voor WhatsApp stel je hem in bij de WhatsApp-afzender.
- Plak het adres precies zoals getoond: Twilio ondertekent elk verzoek samen met het adres, dus een gewijzigd adres zakt voor de controle.
Een antwoord van iemand met een open gesprek op dat kanaal wordt aan dat gesprek toegevoegd, en wie het gesprek opende krijgt een melding. Een bericht van iemand anders verschijnt niet in Polzy. Zie Twilio: Messaging webhooks.
WhatsApp-berichten gaan via een WhatsApp-afzender die je in de Twilio Console registreert onder Messaging → Senders → WhatsApp senders: je koppelt een WhatsApp Business-account via Meta, verifieert het nummer en rondt de bedrijfsverificatie van Meta af voordat je live gaat. Vul het nummer in Polzy in als WhatsApp-afzendernummer. Zie Twilio: Register WhatsApp senders using Self Sign-up.
WhatsApp laat een bedrijf alleen vrij schrijven binnen 24 uur na het laatste bericht van de persoon. Daarbuiten accepteert het alleen een sjabloon die Meta heeft goedgekeurd, en Twilio weigert al het andere met fout 63016. Wat dat in Polzy betekent:
- Campagne-uitnodigingen worden als gewone berichten verstuurd, dus WhatsApp levert ze alleen af bij mensen die je WhatsApp-nummer de afgelopen 24 uur een bericht stuurden. Voor alle anderen mislukt het bericht met fout 63016. Gebruik voor een eerste contact sms of e-mail.
- Gesprekken. Binnen 24 uur na het laatste bericht van de persoon antwoord je vrij. Daarna zegt Polzy WhatsApp staat vrije antwoorden alleen toe binnen 24 uur na hun laatste bericht. Verstuur een goedgekeurde sjabloon om het gesprek te heropenen.
- Sjablonen. Twilio verstuurt een goedgekeurde sjabloon alleen via zijn content-ID, en dat stuurt Polzy niet mee: een sjabloon die je met Sjabloon verzenden kiest, gaat via Twilio als gewone tekst, en Twilio weigert die buiten het venster. Met Twilio gaat het gesprek verder zodra de persoon weer schrijft.
Zie Twilio: Send WhatsApp notification messages with templates en Twilio: Error 63016.
Limieten en kosten
- Sms-segmenten. Een sms bevat tot 160 tekens, of 70 als de tekst een teken buiten het standaard GSM-alfabet bevat — een emoji, of een schrift zoals het Arabisch. Een langer bericht gaat in delen, en Twilio rekent elk deel.
- Stille uren. Met Stille uren respecteren aan onder Instellingen → Meldingen wachten campagneberichten tot 08:00 in de tijdzone van de ontvanger in plaats van tussen 20:00 en 08:00 te vertrekken.
- De limieten van je account. De eigen verzendlimieten en landenregels van Twilio gelden.
Problemen oplossen
| Wat je ziet | Waarom, en wat je doet |
|---|---|
| Authenticate | Twilio weigerde de Account SID en Auth Token. Kopieer ze allebei opnieuw; is de token in Twilio gewijzigd, gebruik dan de nieuwe. |
| Either Messaging Service SID or From Number is required | Vul een Messaging Service SID of een Afzendertelefoonnummer in. |
| Berichten mislukken met Permission to send an SMS has not been enabled for the region | Sta dat land toe in de geografische sms-rechten van je Twilio-account. |
| WhatsApp-berichten mislukken met fout 63016 | De persoon heeft je WhatsApp-nummer de afgelopen 24 uur niet geschreven (zie WhatsApp). |
| Sms is in een campagne niet beschikbaar | SMS staat uit, of heeft geen provider, onder Instellingen → Meldingen → Kanalen. |
| Antwoorden komen niet binnen | Controleer de webhook voor inkomende berichten in Twilio, en dat het adres precies is geplakt. Het deel Activiteit op de pagina van Twilio toont Binnenkomend bericht geweigerd als de controle mislukt, bijvoorbeeld nadat de Auth Token in Twilio wel en in Polzy niet is gewijzigd. |
Goed om te weten
- Een nieuwe Auth Token. Wijzig je de Auth Token in Twilio, vul de nieuwe dan meteen in Polzy in (Configureren): versturen, afleverbevestigingen en antwoorden gebruiken hem allemaal.
- De eigen afzender van Polzy. Zonder eigen provider gaat sms in één richting uit vanaf de gedeelde afzender van Polzy, telt hij mee voor de maandelijkse berichten van je organisatie, en kunnen mensen niet terug-sms'en. WhatsApp gaat via je eigen Telnyx- of Twilio-account tot het WhatsApp-nummer van Polzy is geverifieerd.
- Als Twilio niet meer werkt, blijft Polzy het proberen en markeert het als Vereist aandacht. Koppel je het los, dan gaat sms weer via de gedeelde afzender van Polzy.
- Wat Polzy bewaart. De Auth Token wordt versleuteld opgeslagen en nooit meer getoond.
Handige links
Gerelateerde artikelen
Ingelogde leden kunnen het Polzy vragen of het team een bericht sturen via Support. Hoe snel we antwoorden, hangt af van je abonnement.