Sms en WhatsApp versturen met je eigen Telnyx-account
Koppel Telnyx 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 Telnyx-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 Telnyx-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 Telnyx 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 Telnyx-account met een telefoonnummer dat berichten kan versturen, gekoppeld aan een messaging profile.
- Voor WhatsApp: een WhatsApp Business-account dat in Telnyx is gekoppeld, op een Telnyx-nummer (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 Telnyx gebruikt
- Sms en WhatsApp. Zodra je Telnyx 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 Telnyx.
- Wat het kost. Telnyx 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: Telnyx instellen
- Koop of porteer in het Telnyx-portaal een nummer dat berichten kan versturen, voor elk land waarnaar je verstuurt.
- Maak onder Messaging een messaging profile aan en koppel je nummer eraan. Een profiel regelt nummerpooling en afleverinstellingen.
- Maak onder API Keys een sleutel aan en kopieer hem. Telnyx toont hem één keer.
- Open onder Keys & Credentials het deel Public Key en kopieer de sleutel. Polzy controleert daarmee dat afleverbevestigingen en antwoorden echt van Telnyx komen.
Wil je met een naam in plaats van een nummer versturen, zoals Acme, stel dan een alfanumerieke afzender-ID in op het messaging profile. Mensen kunnen daar niet op antwoorden, het bereikt de Verenigde Staten en Canada niet, en sommige landen eisen dat het eerst wordt geregistreerd.
Zie Telnyx: Create and manage API keys, Telnyx: Messaging profiles en Telnyx: Alphanumeric sender ID.
Stap 2: Telnyx koppelen in Polzy
- Open Integraties in de zijbalk, het tabblad Beschikbaar, en klik op Verbinden in de rij van Telnyx. Of open Berichten, het tabblad Integraties, en klik op Instellen bij Telnyx.
- Vul in het paneel Telnyx koppelen de velden in:
| Veld | Wat je invult |
|---|---|
| API key | De sleutel uit stap 1. Verplicht. |
| Messaging profile ID | De ID van het profiel waar je nummer op staat. Aanbevolen voor sms. |
| Afzendernummer | Je Telnyx-nummer in internationale notatie (E.164), zoals +15550000000. |
| Alpha sender | Een afzendernaam voor internationale sms, 3 tot 11 letters of cijfers, dezelfde als op het messaging profile. Mensen kunnen er niet op antwoorden. |
| WhatsApp-nummer | Het nummer dat bij je WhatsApp Business-account is geregistreerd, voor WhatsApp. |
| Openbare webhooksleutel | De openbare sleutel uit stap 1. Zonder deze sleutel worden afleverbevestigingen en antwoorden geweigerd. |
Vul voor sms een Afzendernummer of een Alpha sender in: Polzy heeft er één van nodig om te versturen, ook met een messaging profile. Staan beide ingevuld, dan wordt het nummer gebruikt, zodat mensen kunnen antwoorden.
- Klik op Verbinding testen. Je ziet Connected to Telnyx met het aantal messaging profiles dat de sleutel kan zien (deze melding is in het Engels).
- Klik op Verbinden.
Stap 3: Telnyx kiezen voor sms en WhatsApp
- Open Instellingen, dan het tabblad Meldingen, en scrol naar Kanalen.
- Wijzig in de rij SMS Polzy · gedeeld account in Telnyx, 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 Telnyx 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 Telnyx bij elk verstuurd bericht om een bevestiging. Voor antwoorden is één instelling in Telnyx nodig.
- Open in Polzy de pagina van Telnyx vanuit Integraties en zoek Ontvangen. Kopieer het adres dat daar staat.
- Open in het Telnyx-portaal je messaging profile en plak het adres als inbound webhook URL. Sla op.
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 Telnyx: Receiving webhooks for messaging.
WhatsApp-berichten gaan via een WhatsApp Business-account dat je in Telnyx koppelt, onder Messaging → WhatsApp, door je aan te melden met je zakelijke Meta-account en je nummer te verifiëren. Vul dat nummer in Polzy in als WhatsApp-nummer. Zie Telnyx: Send your first WhatsApp message.
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. 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, en het logboek toont de reden van Telnyx. 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. Kies een sjabloon onder Kies een goedgekeurde sjabloon en klik op Sjabloon verzenden.
- Sjablonen. Sjablonen worden in Telnyx gemaakt en door Meta goedgekeurd, meestal binnen een à twee dagen. De lijst in Polzy toont de sjablonen die voor je werkruimte zijn geregistreerd; Polzy heeft geen scherm om er een toe te voegen, dus als er Nog geen goedgekeurde sjablonen staat, gaat het gesprek verder zodra de persoon weer schrijft.
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 Telnyx 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 Telnyx gelden.
Problemen oplossen
| Wat je ziet | Waarom, en wat je doet |
|---|---|
| A from number, alpha sender, or WhatsApp number is required | Vul minstens één afzender in. Voor sms een Afzendernummer of een Alpha sender. |
| De test mislukt met een melding van Telnyx over authenticatie | De API-sleutel is verkeerd getypt, verwijderd of verlopen. Maak een nieuwe aan. |
| Berichten mislukken met No SMS sender configured | Alleen een messaging profile is ingesteld. Voeg een Afzendernummer of een Alpha sender toe. |
| Berichten mislukken met No WhatsApp sender configured | Vul WhatsApp-nummer in. |
| Sms is in een campagne niet beschikbaar | SMS staat uit, of heeft geen provider, onder Instellingen → Meldingen → Kanalen. |
| Statussen komen nooit verder dan Verzonden, of antwoorden komen niet binnen | Openbare webhooksleutel is leeg of fout: het deel Activiteit op de pagina van Telnyx toont Binnenkomend bericht geweigerd. Controleer voor antwoorden ook de inbound webhook URL op het messaging profile. |
| Mensen kunnen niet antwoorden | Het bericht ging uit vanaf een Alpha sender. Voeg een Afzendernummer toe. |
| WhatsApp-berichten mislukken | De persoon heeft je nummer de afgelopen 24 uur niet geschreven (zie WhatsApp), of het nummer is in Telnyx niet voor WhatsApp geregistreerd. |
Goed om te weten
- 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 Telnyx 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 API-sleutel en de openbare sleutel worden 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.