Send SMS Broadcast

Post

https://api.bunce.so/v1/broadcast/send/sms

Send

If successful, your response includes a message that your message has been sent successfully. If there is an error with any of the parameters, it will return a 422 HTTP status code with details in an error object.

Request

Body Parameters required

sender_email string<email> required	Sender Email
sender_name string<email> required	Sender Name
email string<email> required	Recipient Email
subject string required	Message Subject
cc array [] optional	Array containing emails to copy
bcc array [] optional	Array containing emails to blind copy
reply_to array [] optional	Array containing emails to reply to
message string required	Broadcast Content
message_type string required	Message Type
all_customers boloean optional	Add this option to send message to all customers
recipients array optional	Recipient array. Required if all_customers key is not present in the request or is false. Possible values for type customer segment
schedule_type string required	Broadcast Schedule type. Possible values for type send-now send-later
schedule_date array [ schedule_date: date; timezone: string; ] optional	Required if schedule type is send-later

Recipients

The recipients field is an array that is required if all_customer is not sent in the payload or if all_customers is set to false . Each recipient object should contain the following fields:

Field	Description
type string required	The type of recipient. Accepted values are customer and segment.
customers array required if recipient type is customer	customer_id string required if email is not present email email required if customer_id is not present first_name string optional last_name string optional phone_no string optional

A new customer record will be created for the customer object passed or updated if the customer email or customer_id already exist.

cURL

curl --request POST \
  --url https://api.bunce.so/v1/broadcast/send/sms \
  --header 'Content-Type: application/json' \
  --header 'X-Authorization: sk_live_************************' \
  --data '{
    "subject" : "Broadcast Test",
    "message" : "This is a tes SMS broadcast message",
    "recipients": {
        "type" : "customer",
        "customers": [
            {
              "phone_no": "+234944874874",
              "email": "email1@gmail.com"
            }
        ]
    },
    "schedule_type": "send-now",
    "track_links": true,
    "include_unsubscribe_link": true
}'

Go

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://api.bunce.so/v1/messaging/transactional/send/sms"

	payload := strings.NewReader("{\n    \"subject\": \"Broadcast Test\",\n    \"message\": \"This is a tes SMS broadcast message\",\n    \"recipients\": {\n        \"type\": \"customer\",\n        \"customers\": [\n            {\n                \"phone_no\": \"+234944874874\",\n                \"email\": \"email1@gmail.com\"\n            }\n        ]\n    },\n    \"schedule_type\": \"send-now\",\n    \"track_links\": true,\n    \"include_unsubscribe_link\": true\n}")

  req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Authorization", "sk_live_************************")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

Node

const  = ('node-fetch')

let  = 'https://api.bunce.so/v1/broadcast/send/sms'

let  = {
  : 'POST',
  : {
    'X-Authorization': 'sk_live_************************',
    'Content-Type': 'application/json',
  },
  : '{"subject":"Broadcast Test","message":"This is a tes SMS broadcast message","recipients":{"type":"customer","customers":[{"phone_no":"+234944874874","email":"email1@gmail.com"}]},"schedule_type":"send-now","track_links":true,"include_unsubscribe_link":true}',
}

(, )
  .then(() => .json())
  .then(() => .())
  .catch(() => .('error:' + ))

PHP

<?php

$client = new http\Client;
$request = new http\Client\Request;

$body = new http\Message\Body;
$body->append('{
    "subject" : "Broadcast Test",
    "message" : "This is a tes SMS broadcast message",
    "recipients": {
        "type" : "customer",
        "customers": [
            {
              "phone_no": "+234944874874",
              "email": "email1@gmail.com"
            }
        ]
    },
    "schedule_type": "send-now",
    "track_links": true,
    "include_unsubscribe_link": true
}');

$request->setRequestUrl('https://api.bunce.so/v1/broadcast/send/sms');
$request->setRequestMethod('POST');
$request->setBody($body);

$request->setHeaders([
  'X-Authorization' => 'sk_live_************************',
  'Content-Type' => 'application/json'
]);

$client->enqueue($request)->send();
$response = $client->getResponse();

echo $response->getBody();

Java

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.bunce.so/v1/broadcast/send/sms"))
    .header("X-Authorization", "sk_live_************************")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\n    \"subject\": \"Broadcast Test\",\n    \"message\": \"This is a tes SMS broadcast message\",\n    \"recipients\": {\n        \"type\": \"customer\",\n        \"customers\": [\n            {\n                \"phone_no\": \"+234944874874\",\n                \"email\": \"email1@gmail.com\"\n            }\n        ]\n    },\n    \"schedule_type\": \"send-now\",\n    \"track_links\": true,\n    \"include_unsubscribe_link\": true\n}"))
    .build();
HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Response

{
  "success": true,
  "data": null,
  "message": "SMS broadcast sent successfully"
}