Send Whatsapp Message
Post
bash
https://api.bunce.so/v1/braocast/send/whatsappSend
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
subject string required | Message Subject |
message string required | Broadcast Content |
whatsapp_template_id string required | Id of whatsapp template to use |
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 |
|
A new customer record will be created for the customer object passed or updated if the customer email or customer_id already exist.
bash
curl --request POST \
--url https://api.bunce.so/v1/broadcast/send/whatsapp \
--header 'Content-Type: application/json' \
--header 'X-Authorization: sk_live_************************' \
--data '{
"subject" : "Broadcast Test",
"message" : "This is a test Whatsapp broadcast message",
"whatsapp_template_id" : "77384334",
"recipients": {
"type" : "customer",
"customers": [
{
"customer_id": "9342743433498234",
"first_name": "Mfon",
"last_name": "Robert",
"email": "email353@gmail.com",
"phone_no" : "+2348062295588"
},
{
"customer_id": "67234qewq6FG",
"first_name": "Zigler",
"last_name": "Rose",
"email": "email564@gmail.com",
"phone_no" : "+2349088779879"
}
]
},
"schedule_type": "send-now"
}'go
package main
import (
"fmt"
"strings"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api.bunce.so/v1/broadcast/send/push-notification"
payload := strings.NewReader("{\n \"subject\": \"Broadcast Test\",\n \"message\": \"This is a test Whatsapp 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}")
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))
}js
const = {
: 'POST',
: {
'X-Authorization': 'sk_live_************************',
'Content-Type': 'application/json',
},
: '{"subject":"Broadcast Test","message":"This is a test Whatsapp broadcast message","whatsapp_template_id":"77384334","recipients":{"type":"customer","customers":[{"customer_id":"9342743433498234","first_name":"Mfon","last_name":"Robert","email":"email353@gmail.com","phone_no":"+2348062295588"},{"customer_id":"67234qewq6FG","first_name":"Zigler","last_name":"Rose","email":"email564@gmail.com","phone_no":"+2349088779879"}]},"schedule_type":"send-now"}',
}
(
'https://api.bunce.so/v1/broadcast/send/push-notification',
,
)
.(() => .())
.(() => .())
.(() => .())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 test Whatsapp broadcast message",
"whatsapp_template_id" : "77384334",
"recipients": {
"type" : "customer",
"customers": [
{
"customer_id": "9342743433498234",
"first_name": "Mfon",
"last_name": "Robert",
"email": "email353@gmail.com",
"phone_no" : "+2348062295588"
},
{
"customer_id": "67234qewq6FG",
"first_name": "Zigler",
"last_name": "Rose",
"email": "email564@gmail.com",
"phone_no" : "+2349088779879"
}
]
},
"schedule_type": "send-now"
}');
$request->setRequestUrl('https://api.bunce.so/v1/broadcast/send/push-notification');
$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/whatsapp"))
.header("X-Authorization", "sk_live_************************")
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString("{\n \"subject\": \"Broadcast Test\",\n \"message\": \"This is a test Whatsapp 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}"))
.build();
HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());Response
json
{
"success": true,
"data": null,
"message": "Whatsapp broadcast sent successfully"
}