Hoe verstuurt u sms'en vanuit uw software?
Uw online agenda, uw website of uw interne tool verstuurt zelf de herinneringen en bevestigingen per sms, zonder dat iemand via One moet gaan. U hoeft uw ontwikkelaar alleen een sleutel te geven.
Alleen voor beheerders
Deze pagina is voorbehouden aan de eigenaar en de beheerders van het account, en aan de leden met niveau Admin in SMS.
Een sleutel aanmaken
Open ‘Integraties’
In SMS › Instellingen, blok Integraties.
Klik op ‘Sleutel aanmaken’
De knop staat bovenaan het blok API Sleutels, dat ook uw bestaande sleutels toont.
API Sleutels
Beheer uw API sleutels voor programmatisch SMS versturen.
Geef de sleutel een naam en klik op ‘Aanmaken’
Kies een Sleutelnaam die zegt welke software hem gebruikt, bijvoorbeeld ‘Website’.
Kopieer de sleutel meteen
Het venster API Sleutel aangemaakt toont de volledige sleutel. Klik op Kopiëren en plak hem in uw software, of bezorg hem aan uw ontwikkelaar.
Kopieer deze sleutel nu. Deze is niet meer zichtbaar na sluiting.
De volledige sleutel verschijnt maar één keer
Zodra het venster gesloten is, toont One alleen nog het begin. Bent u hem kwijt, verwijder hem dan en maak een nieuwe aan. Met een sleutel kan men sms'en versturen in naam van uw bedrijf: behandel hem als een wachtwoord.
Wat uw ontwikkelaar op de pagina vindt
Onder de sleutels geeft het blok API Documentatie het Endpoint om aan te roepen (met een knop om het te kopiëren), de Parameters, Codevoorbeelden in cURL, JavaScript, PHP en Python, en een voorbeeld van het Antwoord. De sleutel gaat mee in de header X-API-Key van het verzoek.
| Parameter | Vereist | Inhoud |
|---|---|---|
to | Ja | Het nummer van de ontvanger in internationaal formaat, of een lijst nummers. |
message | Ja | De tekst van de sms. |
from | Nee | De afzendernaam. Ontbreekt hij, dan geldt de standaardafzender uit de instellingen. |
Goed om te weten
- De toegang even afsluiten: zet de schakelaar van de sleutel om. Hij wordt Inactief en de software kan geen sms'en meer versturen, tot u hem opnieuw inschakelt.
- Een sleutel verwijderen: klik op het prullenbakicoon en daarna op Verwijderen in API Sleutel verwijderen. Dat is definitief: gebruik liever de schakelaar als u hem later opnieuw wilt gebruiken.
- Elke sleutel toont zijn status, het begin van de sleutel, de aanmaakdatum (Aangemaakt op) en Laatst gebruikt.
- Sms'en die via de API vertrekken, verschijnen in de geschiedenis, net als die vanuit One.
- SMS-API-sleutel of token van de One-API? Dat is niet hetzelfde. De sms-sleutel dient alleen voor het versturen van sms'en zoals hier beschreven. De tokens van de One-API, aangemaakt in de accountinstellingen, geven toegang tot de andere modules.