Logg inn

Prøv gratis

Markedsførings-SMS – eksempler

Eksempler på bruk av Simple markedsføring. Simple API tar imot mottakerne som én streng atskilt med semikolon - grupper fra adresseboken, administratorer og alternative kanaler finnes bare i Advanced API.

Flere mottakere

number er en streng med telefonnumre atskilt med semikolon; alle får den samme teksten.

POST /api/1.0/simple/promotional HTTP/1.1 Host: portal.bulkgate.com Content-Type: application/json { "application_id": 451, "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj", "number": "420777777777;420606606234;420601992992", "text": "Spring sale starts today, up to 50 % off." }

Egen avsender og Unicode

gText sender kampanjen fra en registrert tekstavsender. Slå på unicode hver gang teksten inneholder tegn utenfor 7-biters alfabetet - det forkorter meldingen til 268 tegn per del.

Lokale numre og planlagt kampanje

Med country kan du oppgi numre uten internasjonalt prefiks. schedule godtar ISO 8601 eller et Unix-tidsstempel.

POST /api/1.0/simple/promotional HTTP/1.1 Host: portal.bulkgate.com Content-Type: application/json { "application_id": 451, "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj", "number": "777777777;606606234", "country": "cz", "text": "Spring sale starts today, up to 50 % off.", "schedule": "2026-09-14T09:00:00+02:00" }

Beskyttelse mot duplikater og tag

same_text forkaster en melding med samme tekst til et nummer som allerede har fått den, same_number forkaster alle videre meldinger til samme nummer. tag merker kampanjen slik at du kan finne den igjen senere.

Svaret er beskrevet i spesifikasjonen.

Kodeeksempler

Nedenfor finner du eksempler på implementering av Simple API for sending av markedsførings-SMS med tekstavsender i ulike programmeringsspråk:

PHP
PHP cURL
PHP Guzzle
Go
Python
Node.js
Java
Kotlin
C# .NET
C++ libcurl
Ruby
Bash cURL

Betydningen av de enkelte parameterne finner du i spesifikasjonen, og selve forespørslene uten innpakning under forespørselsmetoder.

PHP

php.net

$context = stream_context_create(['http' => [ 'method' => 'POST', 'header' => 'Content-Type: application/json', 'content' => json_encode([ 'application_id' => 451, 'application_token' => 'NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj', 'number' => implode(';', [ '420777777777', '420606606234', '420601992992' ]), 'text' => 'Meldingstekst', 'sender_id' => 'gText', 'sender_id_value' => 'BulkGate', ], JSON_THROW_ON_ERROR), 'timeout' => 30, 'ignore_errors' => true, ]]); $body = file_get_contents('https://portal.bulkgate.com/api/1.0/simple/promotional', false, $context); if ($body === false) { throw new RuntimeException('BulkGate API svarte ikke.'); } $response = json_decode($body, true, flags: JSON_THROW_ON_ERROR); if (isset($response['error'])) { throw new RuntimeException("BulkGate: {$response['error']} ({$response['type']})"); } foreach ($response['data']['response'] as $message) { echo $message['status'] === 'error' ? "{$message['number']}: {$message['error']}\n" : "{$message['number']}: {$message['status']} ({$message['sms_id']})\n"; } var_dump($response['data']['total']['status']);

PHP cURL

php.net/curl

$curl = curl_init(); curl_setopt_array($curl, [ CURLOPT_URL => 'https://portal.bulkgate.com/api/1.0/simple/promotional', CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30, CURLOPT_HTTPHEADER => ['Content-Type: application/json'], CURLOPT_POSTFIELDS => json_encode([ 'application_id' => 451, 'application_token' => 'NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj', 'number' => implode(';', [ '420777777777', '420606606234', '420601992992' ]), 'text' => 'Meldingstekst', 'sender_id' => 'gText', 'sender_id_value' => 'BulkGate', ], JSON_THROW_ON_ERROR), ]); $body = curl_exec($curl); $status = curl_getinfo($curl, CURLINFO_RESPONSE_CODE); if ($body === false) { throw new RuntimeException('BulkGate: ' . curl_error($curl)); } $response = json_decode($body, true, flags: JSON_THROW_ON_ERROR); if ($status !== 200) { throw new RuntimeException("BulkGate: {$response['error']} ({$response['type']})"); } foreach($response['data']['response'] as $message) { echo $message['status'] === 'error' ? "{$message['number']}: {$message['error']}\n" : "{$message['number']}: {$message['status']} ({$message['sms_id']})\n"; } var_dump($response['data']['total']['status']);

PHP Guzzle

docs.guzzlephp.org

// composer require guzzlehttp/guzzle use GuzzleHttp\Client; use GuzzleHttp\Exception\GuzzleException; $client = new Client(['timeout' => 30, 'http_errors' => false]); try { $result = $client->post('https://portal.bulkgate.com/api/1.0/simple/promotional', ['json' => [ 'application_id' => 451, 'application_token' => 'NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj', 'number' => implode(';', [ '420777777777', '420606606234', '420601992992' ]), 'text' => 'Meldingstekst', 'sender_id' => 'gText', 'sender_id_value' => 'BulkGate', ]]); } catch (GuzzleException $e) { throw new RuntimeException('BulkGate: ' . $e->getMessage(), previous: $e); } $response = json_decode((string) $result->getBody(), true, flags: JSON_THROW_ON_ERROR); // http_errors => false: en API-feil oppdages først ved kontroll av statuskoden, innholdet bærer beskrivelsen av den. if ($result->getStatusCode() !== 200) { throw new RuntimeException("BulkGate: {$response['error']} ({$response['type']})"); } foreach ($response['data']['response'] as $message) { echo $message['status'] === 'error' ? "{$message['number']}: {$message['error']}\n" : "{$message['number']}: {$message['status']} ({$message['sms_id']})\n"; } var_dump($response['data']['total']['status']);

Go

go.dev

package main import ( "fmt" "strings" "net/http" "io/ioutil" ) func main() { url := "https://portal.bulkgate.com/api/1.0/simple/promotional" payload := strings.NewReader("{\"application_id\": 451, \"application_token\": \"NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj\", \"number\": \"420777777777;420606606234;420601992992\", \"text\": \"Melding\", \"sender_id\": \"gText\", \"sender_id_value\": \"BulkGate\"}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := ioutil.ReadAll(res.Body) fmt.Println(string(body)) }

Python

python.org

# pip install requests import requests response = requests.post('https://portal.bulkgate.com/api/1.0/simple/promotional', json={ 'application_id': 451, 'application_token': 'NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj', 'number': '420777777777;420606606234;420601992992', 'text': 'Melding', 'sender_id': 'gText', 'sender_id_value': 'BulkGate', }, timeout=30) data = response.json() # Et feilsvar har formen {type, code, error, detail} — se tabellen over feiltyper. if 'error' in data: raise RuntimeError(f"BulkGate: {data['error']} ({data['type']})") # En massesending returnerer et resultat for hvert nummer separat. for message in data['data']['response']: if message['status'] == 'error': print(message['number'], message['error']) else: print(message['number'], message['status'], message['sms_id']) print('Oppsummering:', data['data']['total']['status'])

Node.js

nodejs.org

// Node.js 18+ har fetch globalt. Top-level await krever ESM (.mjs eller "type": "module"). const response = await fetch('https://portal.bulkgate.com/api/1.0/simple/promotional', { method: 'POST', headers: {'Content-Type': 'application/json'}, body: JSON.stringify({ application_id: 451, application_token: 'NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj', number: '420777777777;420606606234;420601992992', text: 'Melding', sender_id: 'gText', sender_id_value: 'BulkGate', }), }); const data = await response.json(); // Et feilsvar har formen {type, code, error, detail} — se tabellen over feiltyper. if (!response.ok) { throw new Error(`BulkGate: ${data.error} (${data.type})`); } // En massesending returnerer et resultat for hvert nummer separat. for (const message of data.data.response) { console.log(message.status === 'error' ? `${message.number}: ${message.error}` : `${message.number}: ${message.status} (${message.sms_id})`); } console.log('Oppsummering:', data.data.total.status);

Java

java.net.http.HttpClient

import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://portal.bulkgate.com/api/1.0/simple/promotional")) .header("Content-Type", "application/json") .POST(HttpRequest.BodyPublishers.ofString(""" { "application_id": 451, "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj", "number": "420777777777;420606606234;420601992992", "text": "Melding", "sender_id": "gText", "sender_id_value": "BulkGate" }""")) .build(); HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode() + " " + response.body());

Kotlin

kotlinlang.org

import java.net.URI import java.net.http.HttpClient import java.net.http.HttpRequest import java.net.http.HttpResponse val payload = """ { "application_id": 451, "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj", "number": "420777777777;420606606234;420601992992", "text": "Melding", "sender_id": "gText", "sender_id_value": "BulkGate" } """.trimIndent() val request = HttpRequest.newBuilder() .uri(URI.create("https://portal.bulkgate.com/api/1.0/simple/promotional")) .header("Content-Type", "application/json") .POST(HttpRequest.BodyPublishers.ofString(payload)) .build() val response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString()) println("${response.statusCode()} ${response.body()}")

C# .NET

learn.microsoft.com

using System.Net.Http; using System.Text; var payload = """ { "application_id": 451, "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj", "number": "420777777777;420606606234;420601992992", "text": "Melding", "sender_id": "gText", "sender_id_value": "BulkGate" } """; using var client = new HttpClient(); var response = await client.PostAsync( "https://portal.bulkgate.com/api/1.0/simple/promotional", new StringContent(payload, Encoding.UTF8, "application/json")); Console.WriteLine($"{(int) response.StatusCode} {await response.Content.ReadAsStringAsync()}");

C++ libcurl

curl.se/libcurl

#include <curl/curl.h> #include <iostream> #include <string> static size_t collect(char *data, size_t size, size_t nmemb, std::string *out) { out->append(data, size * nmemb); return size * nmemb; } int main() { const std::string payload = R"json( { "application_id": 451, "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj", "number": "420777777777;420606606234;420601992992", "text": "Melding", "sender_id": "gText", "sender_id_value": "BulkGate" } )json"; CURL *curl = curl_easy_init(); if (curl == nullptr) { std::cerr << "curl_easy_init failed\n"; return 1; } curl_slist *headers = curl_slist_append(nullptr, "Content-Type: application/json"); std::string body; curl_easy_setopt(curl, CURLOPT_URL, "https://portal.bulkgate.com/api/1.0/simple/promotional"); curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers); curl_easy_setopt(curl, CURLOPT_POSTFIELDS, payload.c_str()); curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, collect); curl_easy_setopt(curl, CURLOPT_WRITEDATA, &body); const CURLcode result = curl_easy_perform(curl); long status = 0; curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &status); curl_slist_free_all(headers); curl_easy_cleanup(curl); if (result != CURLE_OK) { std::cerr << curl_easy_strerror(result) << "\n"; return 1; } std::cout << status << " " << body << "\n"; return 0; }

Ruby

ruby-lang.org

require 'json' require 'net/http' uri = URI('https://portal.bulkgate.com/api/1.0/simple/promotional') response = Net::HTTP.post(uri, { 'application_id' => 451, 'application_token' => 'NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj', 'number' => '420777777777;420606606234;420601992992', 'text' => 'Melding', 'sender_id' => 'gText', 'sender_id_value' => 'BulkGate' }.to_json, 'Content-Type' => 'application/json') puts "#{response.code} #{response.body}"

Bash cURL

curl.se

curl --request POST \ --url https://portal.bulkgate.com/api/1.0/simple/promotional \ --header 'Content-Type: application/json' \ --data '{"application_id": 451, "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj", "number": "420777777777;420606606234;420601992992", "text": "Melding", "sender_id": "gText", "sender_id_value": "BulkGate"}'

Var denne siden nyttig?

Spør AI Kopiert