GatewayAPI

Beskrivelse

Dette plugin muliggør, at du kan sende SMS-beskeder fra administrationsdelen af din WordPress side eller via et programmør-venligt API.

Der er også inkluderet et gratis to-faktor SMS-autentificerings-modul, som forstærker login-sikkerheden på din hjemmeside betydeligt.

Alt du har brug for er pluginnet og en gratis GatewayAPI.com konto.

Fremhævede funktioner:

  • 📱Send SMS’er / beskeder

    • Tilføj egen metadata til modtagere for at lave brevfletning.
    • Importér modtagerlister fra CSV/Excel.
    • Administrér modtagergrupper.
    • Administrér masseudsendelser.
    • Nemt API til programmører.
    • Short-codes til tilmelding/afmelding/redigér profil-formularer.
    • Automatisk integration med Contact Form 7.
  • 🔐 To-faktor autentificering

    • Nemt at anvende: Ingen apps skal installeres hos brugerne!
    • Nemt for administratorer: Bare tjek et flueben af og så virker det!
    • Højt sikkerhedsniveau!
    • Vælg roller for at aktivere obligatorisk to-faktor autentifisering.
    • Gen-bekræft ved hvert login eller husk enheder i op til 30 dage.
  • ✊ Modtag SMS-beskeder

    • Brug dine egne keyword(s) eller telefonnumre til at modtage SMS’er.
    • Vis indgående beskeder.
    • Auto-svar på indgående SMS’er.
  • 🔔 Notifikationsmodul for administratorer (BETA)

    • Modtag en SMS når vigtige handlinger sker.
    • Vælg fra en lang liste af handlinger.
    • Modtag en SMS når en ny bruger er oprettet, når sider redigeres eller når nyt indhold udgives.
    • Opsæt hvilke brugere som modtager SMS-beskeder. Kan være rolle-baseret eller bruger-baseret.
    • BETA: Skriv endelig ind omkring hvad I kan lide samt hvad I måtte føle der mangler (eller er i stykker), så vi kan forbedre denne nye funktion.

Nemt at komme i gang:

  • Komplet trin-for-trin brugerguide med screenshots.
  • Pluginnet har adskillige hjælpetekster.
  • Live chat-support og mail-support fra GatewayAPI.com.

SMS-beskeder leveret af en af de førende SMS Gateways i Europa

  • GatewayAPI.com sender over hundrede millioner SMS’er hvert år på vegne af titusindvis af kunder jorden rundt.
  • Kontorer i København, Odense og Aalborg.
  • Virksomhed stiftet i 1999.
  • Gratis support, intet abonnement OG lave priser.
  • De fleste SMS-beskeder leveres inden for 0,3 sekunder.

Hvis du foretrækker at slå brugerfladerne fra og håndtere udsendelser via kode i stedet, så er det også muligt. Til det formål, kan du benytte metoden `gwapi_send_sms`. Metoden understøtter specifikation af indhold, udsendelse til flere modtagere, afsender-tekst, type af SMS samt valgfri argumenter.

Kom godt i gang

Vi har lavet et par videoer, som viser hvordan man kommer i gang, og bruger de forskellige funktioner. Se den følgende video for hjælp til installation og til at få sendt din første SMS:

Klik her for flere videoer.

Hvordan man gør

Alm. brugere: Brugerguide

De fleste emner gennemgåes trinvist med screenshots i vores brugervejledning – selv ret avancerede emner dækkes.

Åben brugervejledningen

Avanceret: Programmør-API

Send en SMS til en eller flere modtagere ved at kalde gwapi_send_sms med de følgende argumenter

  • $message (string) En tekststreng bestående af beskeden som skal sendes.
  • $recipients (array|string) En enkelt modtager eller en liste af modtagere.
  • $sender (string, valgfri) Afsendertekst (11 tegn eller 15 tal)
  • $destaddr (string, valgfri) Type af SMS – kan være MOBILE (alm. SMS) eller DISPLAY (vises ovenpå hvad end brugeren har åbent, uden at blive gemt i telefonen)

Returnerer GatewayAPI.com besked-ID’et ved success og en WP_Error ved fejl.

Modtager-argumentet kan bestå af enten:

  • En integer eller string, bestående af MSISDN (landekode + telefonnummer, kun tal).
    Eksempelnummer: Landekode 45. Telefonnummer: 12 34 56 78.
    Skrevet som MSISDN: “4512345678”.
  • Et array bestående af MSISDN’er (se ovenfor).
  • Et array hvori MSISDN’er er nøglerne og værdierne er et arrays af tags.
    Eksempel i JSON:
    { “4512345678”: { “%NAME%”: “John Doe”, “%GENDER%”: “Male” } }

Bemærk: SMS’er sendt via gwapi_send_sms gemmes IKKE i WordPress. De er dog stadig tilgængelige via trafik-loggen i din konto på GatewayAPI.com

**Screenshots**

Opsæt din OAuth-nøgle og hemmelighed hér. Denne indstillings-side er kun tilgængelig for administrator.

Hvis SMS-afsendelses-brugerfladen er aktiveret, kan du sende SMS’er fra backenden.

Contact Form 7: GatewayAPI tilføjer automatisk ekstra felter og formularer som understøtter tilmeld/opdatér/afmeld i Contact Form 7’s formularopbygger.

Contact Form 7: Opret “Vælg modtager-grupper”-felt.

Skærmbilleder

  • Opsæt din OAuth-nøgle og hemmelighed hér. Denne indstillings-side er kun tilgængelig for administrator.
  • Hvis SMS-afsendelses-brugerfladen er aktiveret, kan du sende SMS'er fra backendet.
  • Contact Form 7: GatewayAPI tilføjer automatisk ekstra felter og formularer som understøtter tilmeld/opdatér/afmeld i Contact Form 7's formularopbygger.
  • Contact Form 7: Opret "Vælg modtager-grupper"-felt.

Installation

Denne sektion beskriver, hvordan man installerer pluginnet, og får det til at virke.

  1. Hvis du ikke har gjort det allerede, så gå ind på GatewayAPI.com og opret en gratis konto.
  2. Installér og aktivér pluginnet.
  3. Gå ind i “Indstillinger > GatewayAPI Opsæt” og tilføj en OAuth-nøgle samt tilhørende hemmelighed fra din GatewayAPI.com-konto.
  4. (Valgfri) Slå afsendelsesbrugerfladen til og gå så til “SMS’er » Opret SMS” og forsøg at sende en SMS til dig selv, så du kan bekræfte, at det hele virker hensigtsmæssigt.

Vi har også produceret en række videoer for at hjælpe dig i gang:

KOM GODT I GANG

Denne video viser, hvordan du installerer GatewayAPI Pluginnet til WordPress, opsætter det samt sender din første SMS.

MODTAGERE, GRUPPER OG EKSTRA-FELTER

Denne video viser, hvordan du opretter grupper, tilføjer modtagere hertil og tilføjer egne felter til modtagerne, som muliggør at ekstra data gemmes og benyttes til brevfletning i SMS’er.

INDBYGGEDE FORMULARER TIL TILMELDING, OPDATERING OG AFMELDING

Denne video viser, hvordan du opretter formularer til besøgende med det indbyggede UI til at oprette “shortcodes” (dvs. små stykker kode der kan indsættes på alle WordPress-sider).

IMPORTERING AF MODTAGERE FRA REGNEARK

Denne video viser, hvordan du importerer modtagere fra et vilkårligt regneark og ind i modtagerdatabasen. Det viser også, hvordan man overskriver og opdaterer databasen, importerer ekstrafelter fra regnearket, og hvordan man grupperer modtagere. Det virker med alle regnearks-programmer (Excel, Numbers, LibreOffice, Google Docs – og mange flere!)

FAQ

Hvordan klarer pluginnet 10.000+ modtagere?

Det virker rigtigt fint. Vi opdeler store SMS-udsendelser i mindre klumper, så WordPress ikke bliver overbelastet. Der vil her blive vist en progress-bar, når der sendes til over 500 modtagere ad gangen.

HJÆLP! Jeg er administrator, og jeg er blevet låst ude af to-faktor systemet!

Hvis du ikke har en backup af “Nødadgangs URL” fra opsætningsskærmen, så skal du grave igennem databasen for at slå to-faktor fra. Din webudbyder har sandsynligvis værktøjet phpMyAdmin, som du kan benytte til at tilgå databaselaget.
Find så options-tabellen, som standard wp_options. Søg efter rækken hvor option_name er gwapi_security_enable. Slet blot rækken.

Anmeldelser

17. august, 2018
This plugin add´s a really good feature with two factor authentication trough sms, very easy to setup and configure. Works without any app just simple sms so everybody can use it. Good feature is that you can also configure how often you need to verify login with sms.
3. september, 2016
Have tried several free and premium sms plugins for WordPress, this one was by far the most stable and feature rich
3. september, 2016
If you want to send SMS'es from WordPress and manage a list of recipients, perhaps even group them, then this plugin is excellent. It's simple and it just works. Also a nice touch that you get €2 free of send-credit. Should get most people started as the GatewayAPI.com in general has some quite competitive pricing.
Read all 3 reviews

Bidragsydere & udviklere

“GatewayAPI” is open source software. The following people have contributed to this plugin.

Bidragsydere

“GatewayAPI” er blevet oversat til 1 sprog. Tak til oversætterne for deres bidrag.

Translate “GatewayAPI” into your language.

Interesseret i udvikling?

Gennemse koden, tjek SVN repository, eller abonner på udviklerloggen via RSS.

Ændringslog

1.8.3

  • Compability up to WordPress 6.3.1.

1.8.2

  • Bugfix: Built in shortcode defaulted to the posts title as the name of the new recipient. Now defaults to ”, as expected.

1.8.1

  • Bugfix: Built in shortcode for signup did not work properly, when allowing the user to select groups.

1.8.0

  • Support for using our GatewayAPI.eu-setup!
  • Fejlrettelse: 2FA-loginsikkerhed kunne mislykkes på PHP 7.4+.

1.7.6

  • Bugfix: Fixing that GatewayAPI Shortcode for signup had stopped saving some meta-fields since 1.7.2.

1.7.5

  • Fejlrettelse: Standard landekode blev ikke anvendt korrekt i dropdowns for lande.

1.7.4

Kompatibilitet med Contact Form 7.

  • Bugfix: Signup via Contact Form 7 works again (upgraded to being compatible with CF7’s newer window.fetch based approach of AJAX).
  • Bugfix: Notices in CF7-integration (PHP) and a typo, causing an exception in frontend JS on CF7-forms.

1.7.3

Udgivelse af fejlrettelser.

  • Fejlrettelse: Gemning af modtageroplysninger ved hjælp af brugergrænsefladen og via Excel-importer virker igen korrekt.
  • Fejlrettelse: SMS Reply-funktionen virker igen.

1.7.2

Denne version styrker den overordnede sikkerhed takket være input fra en ekstern sikkerhedsrevision.

We highly recommend upgrading to this version, as it hardens the security of our plugin, especially on WordPress-installation with multiple users
which may have users of lower roles than editor.

  • Consistent use of nonce’s in AJAX requests, to prevent CSRF and prevent privilege escalation.
  • Enforce correct roles for various actions, preventing potential privilege escalation.
  • Forbedret sanitizing, validering og escaping af input og output.
  • Alle PHP-filer er nu sikret mod direkte adgang.
  • Refactored function prefixes from gwapi_, _gwapi_ and _gatewayapi_ to gatewayapi_ only.

1.7.1

  • Fejlrettelse: Meddelelser blev ikke sendt.

1.7.0

  • Nyt: Notifikationsmodul: Modtag SMS-notifikationer når diverse handlinger sker i WordPress.
    • BETA: Kontakt os venligst hvis du har ideer/forslag til forbedringer til denne funktion.
  • Nyt: Standard landekodefelt tilføjet (tidligere var alle landevælgere som standard +45/Danmark)
  • Nyt: Programmør-actions gwapi_form_subscribe og gwapi_form_unsubscribe tilføjet. Den første udløses når en ny modtager har tilmeldt sig via vores shortcode-formular og den anden når en modtager har afmeldt sig samme vej.
  • Optimering: Fjernet diverse ikke længere brugte tredjepartsafhængigheder.
  • Dansk oversættelse opdateret, inklusiv notifikationsmodulet.
  • Readme opdateret for at fortælle om notifikationsmodul og andre tekstforbedringer.

1.6.9

  • Nyt! Opret notifikationer automatisk for at give besked til modtagere via SMS, når en WP-action afvikles.

1.6.8

  • Fejlrettelse: Prefiks var ikke specificeret for alle instanser af db_table.

1.6.7

  • Fejlrettelse: Tidligere importerede modtagere blev ikke gen-importeret, hvis de var slettet.

1.6.6

  • Fejlrettelse: Når modtagere blev importeret, blev gruppemodtagere ikke korrekt genoptalt efter import var gennemført.

1.6.5

  • Forbedret: Import af modtagere optimeret.

1.6.4

  • Kompatibel med WordPress 5.5
  • Forbedret: Integration med kontaktformular 7 understøtter nu kortkode for obligatoriske felter
  • Tweak: Opdateret UI og beskrivelser.

1.6.3

  • Kompatibel med WordPress 5.4
  • Nye! Modtagergrupper kan nu som standard ikke markeres, når du bruger kortkode
  • Tweak: Mindre opdateringer til UI.

1.6.2

  • Tweak: The frontend forms now use regular SMS instead of Display SMS for two-factor, as requested by multiple users.
  • Bugfix: When using tags, the list of tags sent to GatewayAPI could end in a situation, with the same tag-data repeated.

1.6.1

  • Fjernet URL i to-faktor SMS, da den var unødvendig og gjorde at SMS’er blev blokeret af GatewayAPI’s nye link-scanner.

1.6.0

  • Nyt! Bestem selv kodning for SMS’er, hvilket muliggør at sende emojis og andre specialtegn.
    • Brugerfladen genkender specialtegn og foreslår selv den billigste kodning, som får SMS’en fejlfrit leveret.
    • API-metoden gwapi_send_sms har nye argumenter for at indstille kodning.
    • Fuldt ud bagudkompatibel, falder tilbage på standard-kodning.
  • Kompatibel med WordPress 5.1

1.5.2

  • Kompatibel med WordPress 5.0.3.
  • Rettelse: Excel-eksport af modtagere virkede ikke med mindre “SMS-indbakker” var aktiveret.
  • Rettelse: Notitser ved Excel-eksport.

1.5.1

  • Opdateret den danske oversættelse (primært vedr. to-faktor-modul samt frontend-formularer).
  • Rettelse: Vores shortcode var ved en fejl blevet omdøbt. Vi understøtter nu både [gwapi] samt [gatewayapi].
  • Rettelse: To-faktor-modul gav fatal error på PHP 5. Rettede også generelle kode-notitser.
  • Rettelse: To-faktor-modul gav fatal error når man oprettede nye WordPress-brugere.

1.5.0

  • Nyt! To-faktor sikkerhedssystem til din WordPress! (valgfrit)
  • Nyt! Sortlist telefonnumre.
  • Forbedret: Søg efter modtager vha. telefonnummer virker.
  • Forbedring: Bedre understøttelse af 10.000+ modtagere + en progress-bar som viser løbende status for afsendelse.

1.4.2

  • Modtagere:
    • Tilføjet mulighed for at sortliste telefonnumre.
    • Tilføjet understøttelse for at søge i modtagerlisten efter telefonnummer (tidl. kun efter navn)
    • Tilføjet drop-down for modtagerliste, for filtrering efter gruppe.
  • Rettelse: Forbedret håndtering ved store modtagerlister (1.000+ modtagere i én afsendelse)

1.4.1

  • Rettelse: Liste over lande er nu altid korrekt bearbejdet, selv via JSON-fil (AJAX-baseret) ikke har korrekt mime-type.

1.4.0

Bemærk: v1.4.0 kan give problemer med dine gamle Contact Form 7-formularer, hvis de indeholder GatewayAPI-felter., da shortcode-syntax er blevet justeret for de fleste af vores felter. Det var nødvendigt aht. oprydning af inkonsistens. Venligst gen-tilføj GatewayAPI-felterne til dine Contact Form 7-formularer.

  • Contact Form 7:

    • Mulighed for at sende SMS’er via frontend.
    • Opdatering af modtager: Formular opdaterer nu kun felter som specifikt vedrører formular.
    • Oprydning og fejlrettelser, forbedret shortcode-syntaks.
  • Komplet brugervejledning til systemet (tilgængelig online).

  • Eksport af modtagere til Excel og CSV.

1.3.3

  • Contact Form 7: Tilføjet understøttelse af formularer som også indeholder et reCaptcha-felt.
  • Oprydning af koden

1.3.2

  • Fejlrettelse: Et menupunkt manglede i backend.

1.3.1

  • Ny brugerflade for at oprette automatiske handlinger. Understøtter pt. ‘autosvar’ baseret på keyword.

1.3.0

  • Understøttelse af at modtage SMS’er, inkl. en wizard til opsætning, samt indbakker.

1.2.3

  • Fejlrettelse: Den nye verifikations-SMS for Contact Form 7 havde en slåfejl som ødelagde verifikations-SMS’er.
  • Manglende oversættelser: Popup-beskederne relateret til verifikation var ikke oversat til dansk.

1.2.2

  • Bedre understøttelse af internationale telefonnumre: Prefikser automatisk 0’er i telefonnummeret.

1.2.1

  • Brugersynkronisering:
    • Ikke længere påkrævet at tilføje et landekodefelt, i stedet falder systemet nu tilbage på standard-landefeltet.
    • Nu muligt at registrere en “engangs”-synkronisering.
  • Contact Form 7:
    • Nu muligt at sende SMS-svar automatisk når formular indsendes.
    • SMS-validering ved tilmelding, før man kan logge ind.
    • Fejlrettelse: Validering virker nu for alle GatewayAPI-felter.

1.2.0

  • Contact Form 7: Integrationen understøtter nu tilmelding, opdatering og afmeld-formularerne i frontend. To-faktor nu muligt i opdaterings-flow.

1.1.6

  • Rettelse: Safari-problem med SMS-tegn-tæller.
  • Fejlrettelse: Skjult påkrævet felt gjorde Opsæt-siden ubrugelig.
  • Opdateret oversættelse af Dansk.

1.1.5

  • Understøttelse af automatisk synkronisering af WordPress-brugere til => modtagere (en-vejs) inkl. meta-felter og grupper.

1.1.4

  • Opdatere WordPress-pluginnets side

1.1.3

Fejlrettelser:
* Opsæt-siden indlæste ikke efter opdatering.
* Manglende CSS/JS.
* Et par kodenotitser løst.

1.1.2

  • Rettelse: Sidste skridt i tilmelding kunne fejl hvis bruger var gæst.

1.1.1

  • Fejlrettelse: Gæster fik ikke fornødent CSS og scripts.

1.1.0

  • Redigérbare egne felter for modtagerne: Opsætningssiden indeholder nu en ‘egne felter’-brugerflade med drag-n-drop-mulighed for at styre rækkefølge.
  • Short code-bygger: Nu muligt at bygge egne shortcodes fra backendet, til tilmelding/opdatering/afmelding samt afsendelse af SMS.
  • Tag-understøttelse for alle egne felter.
  • Importering af modtagere, inkl. egne felter, fra regneark. Understøtter opdatering af eksisterende modtagere og bibeholder grupper for eksisterende modtagere.
  • Fejlrettelse: SMS-brugerflade’s tælles talte forkert for 153-160 tegn lange SMS’er, samt talte nogle specialtegn forkert.
  • Fejlrettelse: Manuelt tilføjede modtagere’s %NAME%-tag virkede ikke.

1.0.1

  • Kosmetiske forbedringer: Et par inkonsistenser er blevet håndteret ift. navngivning og dokumentation.
  • Opryddet en smule: Hvis afsendelsesbrugerfladen ikke er aktiveret, køres nu endnu mindre kode i hver anmodning.

1.0

  • Første version.