POST /messages/send

caution

After 24h without a reply from the customer, it is not possible to send regular messages, you'll need to use a Template message, see examples below.

Required Parameters

Parameter	Type	Description
to	String	Phone number or platform identifier
from	String	Channel identifier (e.g. whatsapp)
type	MessageType	Type of message to be sent
content	MessageContent	Content of the message

Optional Parameters

Parameter	Type	Description
template_uuid	String	Unique identifier of the template message
optin_contact	Boolean	Confirmation that the contact has opted-in for receiving messages
template_values	Array	Values for multi-variable template message
assigned_user	String	Message will be assigned to this collaborator's email
team_uuid	String	Message will be assigned to this team
channel_uuid	String	The message will be sent from this channel (when omitted, it will use the default main channel)
fields	String	Comma-separated fields to be returned in the message. Supported values: contact
bot_status	String	The status of the bot for this contact. Accepts either bot_start or bot_end.

info

When passing bot_status make sure that the bot is enabled in your account. Visit bots in your Callbell account to create and enable one.

If you have a bot enabled, the default status is bot_start meaning that the bot will reply whenever the contact writes. If this is not the intended behavior, you can set the status to bot_end to stop the bot from replying to the contact. This can be useful when you want to take over the conversation manually or when you want to stop the bot from replying to the contact for any other reason.

Example Request

cURL

curl -X POST "https://api.callbell.eu/v1/messages/send" \
  -H "Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+31612345678",
    "from": "whatsapp",
    "type": "text",
    "content": {
      "text": "Hello!"
    }
  }'

Node

import axios from 'axios';

const response = await axios.post(
  'https://api.callbell.eu/v1/messages/send',
  // '{\n    "to": "+31612345678",\n    "from": "whatsapp",\n    "type": "text",\n    "content": {\n      "text": "Hello!"\n    }\n  }',
  {
    'to': '+31612345678',
    'from': 'whatsapp',
    'type': 'text',
    'content': {
      'text': 'Hello!'
    }
  },
  {
    headers: {
      'Authorization': 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
      'Content-Type': 'application/json'
    }
  }
);

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.callbell.eu/v1/messages/send')
req = Net::HTTP::Post.new(uri)
req.content_type = 'application/json'
req['Authorization'] = 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM'

# The object won't be serialized exactly like this
# req.body = "{\n    \"to\": \"+31612345678\",\n    \"from\": \"whatsapp\",\n    \"type\": \"text\",\n    \"content\": {\n      \"text\": \"Hello!\"\n    }\n  }"
req.body = {
  'to' => '+31612345678',
  'from' => 'whatsapp',
  'type' => 'text',
  'content' => {
    'text' => 'Hello!'
  }
}.to_json

req_options = {
  use_ssl: uri.scheme == 'https'
}
res = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
  http.request(req)
end

Go

package main

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

func main() {
    client := &http.Client{}
    var data = strings.NewReader(`{
    "to": "+31612345678",
    "from": "whatsapp",
    "type": "text",
    "content": {
      "text": "Hello!"
    }
  }`)
    req, err := http.NewRequest("POST", "https://api.callbell.eu/v1/messages/send", data)
    if err != nil {
        log.Fatal(err)
    }
    req.Header.Set("Authorization", "Bearer test_gshuPaZoeEG6ovbc8M79w0QyM")
    req.Header.Set("Content-Type", "application/json")
    resp, err := client.Do(req)
    if err != nil {
        log.Fatal(err)
    }
    defer resp.Body.Close()
    bodyText, err := io.ReadAll(resp.Body)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Printf("%s\n", bodyText)
}

PHP

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.callbell.eu/v1/messages/send');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, "{\n    \"to\": \"+31612345678\",\n    \"from\": \"whatsapp\",\n    \"type\": \"text\",\n    \"content\": {\n      \"text\": \"Hello!\"\n    }\n  }");

$response = curl_exec($ch);

curl_close($ch);

Python

import requests

headers = {
    'Authorization': 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
    'Content-Type': 'application/json',
}

json_data = {
    'to': '+31612345678',
    'from': 'whatsapp',
    'type': 'text',
    'content': {
        'text': 'Hello!',
    },
}

response = requests.post('https://api.callbell.eu/v1/messages/send', headers=headers, json=json_data)

# Note: json_data will not be serialized by requests
# exactly as it was in the original request.
#data = '{\n    "to": "+31612345678",\n    "from": "whatsapp",\n    "type": "text",\n    "content": {\n      "text": "Hello!"\n    }\n  }'
#response = requests.post('https://api.callbell.eu/v1/messages/send', headers=headers, data=data)

Response

Parameter	Type	Description
message	MessageSendRequest	The message send request. The system will initially enqueue the message.

Example Response

response.json

{
  "message": {
    "uuid": "adf3d1216d4c4dcd908199d6700f2381",
    "status": "enqueued"
  }
}

Example Response (with fields=contact)

response.json

{
  "message": {
    "uuid": "adf3d1216d4c4dcd908199d6700f2381",
    "status": "enqueued",
    "contact": {
      "uuid": "c7b3d1216d4c4dcd908199d6700f2381",
      "name": "John Doe",
      "phone": "+1234567890",
      "email": "john@doe.com"
    }
  }
}

Send Message with Automatic User Assignment

It is possible to send a message via API request with an assigned user by sending their email in the assigned_user parameter.

caution

The user has to be part of your team, otherwise the assignment will not work.

cURL

curl -X POST "https://api.callbell.eu/v1/messages/send" \
  -H "Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+31612345678",
    "from": "whatsapp",
    "type": "text",
    "content": {
      "text": "Hello! This message has an assigned user!"
    },
    "assigned_user": "john.doe@email.com"
  }'

Node

import axios from 'axios';

const response = await axios.post(
  'https://api.callbell.eu/v1/messages/send',
  // '{\n    "to": "+31612345678",\n    "from": "whatsapp",\n    "type": "text",\n    "content": {\n      "text": "Hello! This message has an assigned user!"\n    },\n    "assigned_user": "john.doe@email.com"\n  }',
  {
    'to': '+31612345678',
    'from': 'whatsapp',
    'type': 'text',
    'content': {
      'text': 'Hello! This message has an assigned user!'
    },
    'assigned_user': 'john.doe@email.com'
  },
  {
    headers: {
      'Authorization': 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
      'Content-Type': 'application/json'
    }
  }
);

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.callbell.eu/v1/messages/send')
req = Net::HTTP::Post.new(uri)
req.content_type = 'application/json'
req['Authorization'] = 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM'

# The object won't be serialized exactly like this
# req.body = "{\n    \"to\": \"+31612345678\",\n    \"from\": \"whatsapp\",\n    \"type\": \"text\",\n    \"content\": {\n      \"text\": \"Hello! This message has an assigned user!\"\n    },\n    \"assigned_user\": \"john.doe@email.com\"\n  }"
req.body = {
  'to' => '+31612345678',
  'from' => 'whatsapp',
  'type' => 'text',
  'content' => {
    'text' => 'Hello! This message has an assigned user!'
  },
  'assigned_user' => 'john.doe@email.com'
}.to_json

req_options = {
  use_ssl: uri.scheme == 'https'
}
res = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
  http.request(req)
end

Go

package main

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

func main() {
    client := &http.Client{}
    var data = strings.NewReader(`{
    "to": "+31612345678",
    "from": "whatsapp",
    "type": "text",
    "content": {
      "text": "Hello! This message has an assigned user!"
    },
    "assigned_user": "john.doe@email.com"
  }`)
    req, err := http.NewRequest("POST", "https://api.callbell.eu/v1/messages/send", data)
    if err != nil {
        log.Fatal(err)
    }
    req.Header.Set("Authorization", "Bearer test_gshuPaZoeEG6ovbc8M79w0QyM")
    req.Header.Set("Content-Type", "application/json")
    resp, err := client.Do(req)
    if err != nil {
        log.Fatal(err)
    }
    defer resp.Body.Close()
    bodyText, err := io.ReadAll(resp.Body)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Printf("%s\n", bodyText)
}

PHP

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.callbell.eu/v1/messages/send');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, "{\n    \"to\": \"+31612345678\",\n    \"from\": \"whatsapp\",\n    \"type\": \"text\",\n    \"content\": {\n      \"text\": \"Hello! This message has an assigned user!\"\n    },\n    \"assigned_user\": \"john.doe@email.com\"\n  }");

$response = curl_exec($ch);

curl_close($ch);

Python

import requests

headers = {
    'Authorization': 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
    'Content-Type': 'application/json',
}

json_data = {
    'to': '+31612345678',
    'from': 'whatsapp',
    'type': 'text',
    'content': {
        'text': 'Hello! This message has an assigned user!',
    },
    'assigned_user': 'john.doe@email.com',
}

response = requests.post('https://api.callbell.eu/v1/messages/send', headers=headers, json=json_data)

# Note: json_data will not be serialized by requests
# exactly as it was in the original request.
#data = '{\n    "to": "+31612345678",\n    "from": "whatsapp",\n    "type": "text",\n    "content": {\n      "text": "Hello! This message has an assigned user!"\n    },\n    "assigned_user": "john.doe@email.com"\n  }'
#response = requests.post('https://api.callbell.eu/v1/messages/send', headers=headers, data=data)

Send Message with Media Attachments

You can use the API to send media messages containing images, documents, audio and video messages.

Is it also possible to add a caption when sending image attachments (see the example request below).

Send Image Attachment Example

cURL

curl -X POST "https://api.callbell.eu/v1/messages/send" \
  -H "Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+31612345678",
    "from": "whatsapp",
    "type": "image",
    "content": {
      "url": "https://example.com/my_image.jpeg"
    }
  }'

Node

import axios from 'axios';

const response = await axios.post(
  'https://api.callbell.eu/v1/messages/send',
  // '{\n    "to": "+31612345678",\n    "from": "whatsapp",\n    "type": "image",\n    "content": {\n      "url": "https://example.com/my_image.jpeg"\n    }\n  }',
  {
    'to': '+31612345678',
    'from': 'whatsapp',
    'type': 'image',
    'content': {
      'url': 'https://example.com/my_image.jpeg'
    }
  },
  {
    headers: {
      'Authorization': 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
      'Content-Type': 'application/json'
    }
  }
);

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.callbell.eu/v1/messages/send')
req = Net::HTTP::Post.new(uri)
req.content_type = 'application/json'
req['Authorization'] = 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM'

# The object won't be serialized exactly like this
# req.body = "{\n    \"to\": \"+31612345678\",\n    \"from\": \"whatsapp\",\n    \"type\": \"image\",\n    \"content\": {\n      \"url\": \"https://example.com/my_image.jpeg\"\n    }\n  }"
req.body = {
  'to' => '+31612345678',
  'from' => 'whatsapp',
  'type' => 'image',
  'content' => {
    'url' => 'https://example.com/my_image.jpeg'
  }
}.to_json

req_options = {
  use_ssl: uri.scheme == 'https'
}
res = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
  http.request(req)
end

Go

package main

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

func main() {
    client := &http.Client{}
    var data = strings.NewReader(`{
    "to": "+31612345678",
    "from": "whatsapp",
    "type": "image",
    "content": {
      "url": "https://example.com/my_image.jpeg"
    }
  }`)
    req, err := http.NewRequest("POST", "https://api.callbell.eu/v1/messages/send", data)
    if err != nil {
        log.Fatal(err)
    }
    req.Header.Set("Authorization", "Bearer test_gshuPaZoeEG6ovbc8M79w0QyM")
    req.Header.Set("Content-Type", "application/json")
    resp, err := client.Do(req)
    if err != nil {
        log.Fatal(err)
    }
    defer resp.Body.Close()
    bodyText, err := io.ReadAll(resp.Body)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Printf("%s\n", bodyText)
}

PHP

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.callbell.eu/v1/messages/send');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, "{\n    \"to\": \"+31612345678\",\n    \"from\": \"whatsapp\",\n    \"type\": \"image\",\n    \"content\": {\n      \"url\": \"https://example.com/my_image.jpeg\"\n    }\n  }");

$response = curl_exec($ch);

curl_close($ch);

Python

import requests

headers = {
    'Authorization': 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
    'Content-Type': 'application/json',
}

json_data = {
    'to': '+31612345678',
    'from': 'whatsapp',
    'type': 'image',
    'content': {
        'url': 'https://example.com/my_image.jpeg',
    },
}

response = requests.post('https://api.callbell.eu/v1/messages/send', headers=headers, json=json_data)

# Note: json_data will not be serialized by requests
# exactly as it was in the original request.
#data = '{\n    "to": "+31612345678",\n    "from": "whatsapp",\n    "type": "image",\n    "content": {\n      "url": "https://example.com/my_image.jpeg"\n    }\n  }'
#response = requests.post('https://api.callbell.eu/v1/messages/send', headers=headers, data=data)

Send Image Attachment & Caption Example

cURL

curl -X POST "https://api.callbell.eu/v1/messages/send" \
  -H "Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+31612345678",
    "from": "whatsapp",
    "type": "image",
    "content": {
      "url": "https://example.com/my_image.jpeg",
      "text: "This is my caption"
    }
  }'

Node

import axios from 'axios';

const response = await axios.post(
  'https://api.callbell.eu/v1/messages/send',
  '{\n    "to": "+31612345678",\n    "from": "whatsapp",\n    "type": "image",\n    "content": {\n      "url": "https://example.com/my_image.jpeg",\n      "text: "This is my caption"\n    }\n  }',
  {
    headers: {
      'Authorization': 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
      'Content-Type': 'application/json'
    }
  }
);

Ruby

require 'net/http'

uri = URI('https://api.callbell.eu/v1/messages/send')
req = Net::HTTP::Post.new(uri)
req.content_type = 'application/json'
req['Authorization'] = 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM'

req.body = "{\n    \"to\": \"+31612345678\",\n    \"from\": \"whatsapp\",\n    \"type\": \"image\",\n    \"content\": {\n      \"url\": \"https://example.com/my_image.jpeg\",\n      \"text: \"This is my caption\"\n    }\n  }"

req_options = {
  use_ssl: uri.scheme == 'https'
}
res = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
  http.request(req)
end

Go

package main

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

func main() {
    client := &http.Client{}
    var data = strings.NewReader(`{
    "to": "+31612345678",
    "from": "whatsapp",
    "type": "image",
    "content": {
      "url": "https://example.com/my_image.jpeg",
      "text: "This is my caption"
    }
  }`)
    req, err := http.NewRequest("POST", "https://api.callbell.eu/v1/messages/send", data)
    if err != nil {
        log.Fatal(err)
    }
    req.Header.Set("Authorization", "Bearer test_gshuPaZoeEG6ovbc8M79w0QyM")
    req.Header.Set("Content-Type", "application/json")
    resp, err := client.Do(req)
    if err != nil {
        log.Fatal(err)
    }
    defer resp.Body.Close()
    bodyText, err := io.ReadAll(resp.Body)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Printf("%s\n", bodyText)
}

PHP

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.callbell.eu/v1/messages/send');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, "{\n    \"to\": \"+31612345678\",\n    \"from\": \"whatsapp\",\n    \"type\": \"image\",\n    \"content\": {\n      \"url\": \"https://example.com/my_image.jpeg\",\n      \"text: \"This is my caption\"\n    }\n  }");

$response = curl_exec($ch);

curl_close($ch);

Python

import requests

headers = {
    'Authorization': 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
    'Content-Type': 'application/json',
}

data = '{\n    "to": "+31612345678",\n    "from": "whatsapp",\n    "type": "image",\n    "content": {\n      "url": "https://example.com/my_image.jpeg",\n      "text: "This is my caption"\n    }\n  }'

response = requests.post('https://api.callbell.eu/v1/messages/send', headers=headers, data=data)

Send Document Attachment Example

cURL

curl -X POST "https://api.callbell.eu/v1/messages/send" \
  -H "Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+31612345678",
    "from": "whatsapp",
    "type": "document",
    "content": {
      "url": "https://example.com/my_image.pdf"
    }
  }'

Node

import axios from 'axios';

const response = await axios.post(
  'https://api.callbell.eu/v1/messages/send',
  // '{\n    "to": "+31612345678",\n    "from": "whatsapp",\n    "type": "document",\n    "content": {\n      "url": "https://example.com/my_image.pdf"\n    }\n  }',
  {
    'to': '+31612345678',
    'from': 'whatsapp',
    'type': 'document',
    'content': {
      'url': 'https://example.com/my_image.pdf'
    }
  },
  {
    headers: {
      'Authorization': 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
      'Content-Type': 'application/json'
    }
  }
);

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.callbell.eu/v1/messages/send')
req = Net::HTTP::Post.new(uri)
req.content_type = 'application/json'
req['Authorization'] = 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM'

# The object won't be serialized exactly like this
# req.body = "{\n    \"to\": \"+31612345678\",\n    \"from\": \"whatsapp\",\n    \"type\": \"document\",\n    \"content\": {\n      \"url\": \"https://example.com/my_image.pdf\"\n    }\n  }"
req.body = {
  'to' => '+31612345678',
  'from' => 'whatsapp',
  'type' => 'document',
  'content' => {
    'url' => 'https://example.com/my_image.pdf'
  }
}.to_json

req_options = {
  use_ssl: uri.scheme == 'https'
}
res = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
  http.request(req)
end

Go

package main

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

func main() {
    client := &http.Client{}
    var data = strings.NewReader(`{
    "to": "+31612345678",
    "from": "whatsapp",
    "type": "document",
    "content": {
      "url": "https://example.com/my_image.pdf"
    }
  }`)
    req, err := http.NewRequest("POST", "https://api.callbell.eu/v1/messages/send", data)
    if err != nil {
        log.Fatal(err)
    }
    req.Header.Set("Authorization", "Bearer test_gshuPaZoeEG6ovbc8M79w0QyM")
    req.Header.Set("Content-Type", "application/json")
    resp, err := client.Do(req)
    if err != nil {
        log.Fatal(err)
    }
    defer resp.Body.Close()
    bodyText, err := io.ReadAll(resp.Body)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Printf("%s\n", bodyText)
}

PHP

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.callbell.eu/v1/messages/send');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, "{\n    \"to\": \"+31612345678\",\n    \"from\": \"whatsapp\",\n    \"type\": \"document\",\n    \"content\": {\n      \"url\": \"https://example.com/my_image.pdf\"\n    }\n  }");

$response = curl_exec($ch);

curl_close($ch);

Python

import requests

headers = {
    'Authorization': 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
    'Content-Type': 'application/json',
}

json_data = {
    'to': '+31612345678',
    'from': 'whatsapp',
    'type': 'document',
    'content': {
        'url': 'https://example.com/my_image.pdf',
    },
}

response = requests.post('https://api.callbell.eu/v1/messages/send', headers=headers, json=json_data)

# Note: json_data will not be serialized by requests
# exactly as it was in the original request.
#data = '{\n    "to": "+31612345678",\n    "from": "whatsapp",\n    "type": "document",\n    "content": {\n      "url": "https://example.com/my_image.pdf"\n    }\n  }'
#response = requests.post('https://api.callbell.eu/v1/messages/send', headers=headers, data=data)

Send Audio Attachment Example

info

This is only available for accounts using the official WhatsApp Business API integration.

cURL

curl -X POST "https://api.callbell.eu/v1/messages/send" \
  -H "Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+31612345678",
    "from": "whatsapp",
    "type": "document",
    "content": {
      "url": "https://example.com/my_audio.mp3"
    }
  }'

Node

import axios from 'axios';

const response = await axios.post(
  'https://api.callbell.eu/v1/messages/send',
  // '{\n    "to": "+31612345678",\n    "from": "whatsapp",\n    "type": "document",\n    "content": {\n      "url": "https://example.com/my_audio.mp3"\n    }\n  }',
  {
    'to': '+31612345678',
    'from': 'whatsapp',
    'type': 'document',
    'content': {
      'url': 'https://example.com/my_audio.mp3'
    }
  },
  {
    headers: {
      'Authorization': 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
      'Content-Type': 'application/json'
    }
  }
);

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.callbell.eu/v1/messages/send')
req = Net::HTTP::Post.new(uri)
req.content_type = 'application/json'
req['Authorization'] = 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM'

# The object won't be serialized exactly like this
# req.body = "{\n    \"to\": \"+31612345678\",\n    \"from\": \"whatsapp\",\n    \"type\": \"document\",\n    \"content\": {\n      \"url\": \"https://example.com/my_audio.mp3\"\n    }\n  }"
req.body = {
  'to' => '+31612345678',
  'from' => 'whatsapp',
  'type' => 'document',
  'content' => {
    'url' => 'https://example.com/my_audio.mp3'
  }
}.to_json

req_options = {
  use_ssl: uri.scheme == 'https'
}
res = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
  http.request(req)
end

Go

package main

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

func main() {
    client := &http.Client{}
    var data = strings.NewReader(`{
    "to": "+31612345678",
    "from": "whatsapp",
    "type": "document",
    "content": {
      "url": "https://example.com/my_audio.mp3"
    }
  }`)
    req, err := http.NewRequest("POST", "https://api.callbell.eu/v1/messages/send", data)
    if err != nil {
        log.Fatal(err)
    }
    req.Header.Set("Authorization", "Bearer test_gshuPaZoeEG6ovbc8M79w0QyM")
    req.Header.Set("Content-Type", "application/json")
    resp, err := client.Do(req)
    if err != nil {
        log.Fatal(err)
    }
    defer resp.Body.Close()
    bodyText, err := io.ReadAll(resp.Body)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Printf("%s\n", bodyText)
}

PHP

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.callbell.eu/v1/messages/send');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, "{\n    \"to\": \"+31612345678\",\n    \"from\": \"whatsapp\",\n    \"type\": \"document\",\n    \"content\": {\n      \"url\": \"https://example.com/my_audio.mp3\"\n    }\n  }");

$response = curl_exec($ch);

curl_close($ch);

Python

import requests

headers = {
    'Authorization': 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
    'Content-Type': 'application/json',
}

json_data = {
    'to': '+31612345678',
    'from': 'whatsapp',
    'type': 'document',
    'content': {
        'url': 'https://example.com/my_audio.mp3',
    },
}

response = requests.post('https://api.callbell.eu/v1/messages/send', headers=headers, json=json_data)

# Note: json_data will not be serialized by requests
# exactly as it was in the original request.
#data = '{\n    "to": "+31612345678",\n    "from": "whatsapp",\n    "type": "document",\n    "content": {\n      "url": "https://example.com/my_audio.mp3"\n    }\n  }'
#response = requests.post('https://api.callbell.eu/v1/messages/send', headers=headers, data=data)

Send Video Attachment Example

info

This is only available for accounts using the official WhatsApp Business API integration.

cURL

curl -X POST "https://api.callbell.eu/v1/messages/send" \
  -H "Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+31612345678",
    "from": "whatsapp",
    "type": "document",
    "content": {
      "url": "https://example.com/my_video.mp4"
    }
  }'

Node

import axios from 'axios';

const response = await axios.post(
  'https://api.callbell.eu/v1/messages/send',
  // '{\n    "to": "+31612345678",\n    "from": "whatsapp",\n    "type": "document",\n    "content": {\n      "url": "https://example.com/my_video.mp4"\n    }\n  }',
  {
    'to': '+31612345678',
    'from': 'whatsapp',
    'type': 'document',
    'content': {
      'url': 'https://example.com/my_video.mp4'
    }
  },
  {
    headers: {
      'Authorization': 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
      'Content-Type': 'application/json'
    }
  }
);

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.callbell.eu/v1/messages/send')
req = Net::HTTP::Post.new(uri)
req.content_type = 'application/json'
req['Authorization'] = 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM'

# The object won't be serialized exactly like this
# req.body = "{\n    \"to\": \"+31612345678\",\n    \"from\": \"whatsapp\",\n    \"type\": \"document\",\n    \"content\": {\n      \"url\": \"https://example.com/my_video.mp4\"\n    }\n  }"
req.body = {
  'to' => '+31612345678',
  'from' => 'whatsapp',
  'type' => 'document',
  'content' => {
    'url' => 'https://example.com/my_video.mp4'
  }
}.to_json

req_options = {
  use_ssl: uri.scheme == 'https'
}
res = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
  http.request(req)
end

Go

package main

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

func main() {
    client := &http.Client{}
    var data = strings.NewReader(`{
    "to": "+31612345678",
    "from": "whatsapp",
    "type": "document",
    "content": {
      "url": "https://example.com/my_video.mp4"
    }
  }`)
    req, err := http.NewRequest("POST", "https://api.callbell.eu/v1/messages/send", data)
    if err != nil {
        log.Fatal(err)
    }
    req.Header.Set("Authorization", "Bearer test_gshuPaZoeEG6ovbc8M79w0QyM")
    req.Header.Set("Content-Type", "application/json")
    resp, err := client.Do(req)
    if err != nil {
        log.Fatal(err)
    }
    defer resp.Body.Close()
    bodyText, err := io.ReadAll(resp.Body)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Printf("%s\n", bodyText)
}

PHP

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.callbell.eu/v1/messages/send');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, "{\n    \"to\": \"+31612345678\",\n    \"from\": \"whatsapp\",\n    \"type\": \"document\",\n    \"content\": {\n      \"url\": \"https://example.com/my_video.mp4\"\n    }\n  }");

$response = curl_exec($ch);

curl_close($ch);

Python

import requests

headers = {
    'Authorization': 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
    'Content-Type': 'application/json',
}

json_data = {
    'to': '+31612345678',
    'from': 'whatsapp',
    'type': 'document',
    'content': {
        'url': 'https://example.com/my_video.mp4',
    },
}

response = requests.post('https://api.callbell.eu/v1/messages/send', headers=headers, json=json_data)

# Note: json_data will not be serialized by requests
# exactly as it was in the original request.
#data = '{\n    "to": "+31612345678",\n    "from": "whatsapp",\n    "type": "document",\n    "content": {\n      "url": "https://example.com/my_video.mp4"\n    }\n  }'
#response = requests.post('https://api.callbell.eu/v1/messages/send', headers=headers, data=data)

Send Template Messages

You can use the API to send an approved Template Message.

info

This is only available for accounts using the official WhatsApp Business API integration.

caution

In order to send template messages template_uuid and optin_contact must be present in the payload.

cURL

curl -X POST "https://api.callbell.eu/v1/messages/send" \
  -H "Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+31612345678",
    "from": "whatsapp",
    "type": "text",
    "content": {
      "text": "John Doe"
    },
    "template_uuid": "d980fb66fd5043d3ace1aa06ba044342",
    "optin_contact": true
  }'

Node

import axios from 'axios';

const response = await axios.post(
  'https://api.callbell.eu/v1/messages/send',
  // '{\n    "to": "+31612345678",\n    "from": "whatsapp",\n    "type": "text",\n    "content": {\n      "text": "John Doe"\n    },\n    "template_uuid": "d980fb66fd5043d3ace1aa06ba044342",\n    "optin_contact": true\n  }',
  {
    'to': '+31612345678',
    'from': 'whatsapp',
    'type': 'text',
    'content': {
      'text': 'John Doe'
    },
    'template_uuid': 'd980fb66fd5043d3ace1aa06ba044342',
    'optin_contact': true
  },
  {
    headers: {
      'Authorization': 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
      'Content-Type': 'application/json'
    }
  }
);

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.callbell.eu/v1/messages/send')
req = Net::HTTP::Post.new(uri)
req.content_type = 'application/json'
req['Authorization'] = 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM'

# The object won't be serialized exactly like this
# req.body = "{\n    \"to\": \"+31612345678\",\n    \"from\": \"whatsapp\",\n    \"type\": \"text\",\n    \"content\": {\n      \"text\": \"John Doe\"\n    },\n    \"template_uuid\": \"d980fb66fd5043d3ace1aa06ba044342\",\n    \"optin_contact\": true\n  }"
req.body = {
  'to' => '+31612345678',
  'from' => 'whatsapp',
  'type' => 'text',
  'content' => {
    'text' => 'John Doe'
  },
  'template_uuid' => 'd980fb66fd5043d3ace1aa06ba044342',
  'optin_contact' => true
}.to_json

req_options = {
  use_ssl: uri.scheme == 'https'
}
res = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
  http.request(req)
end

Go

package main

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

func main() {
    client := &http.Client{}
    var data = strings.NewReader(`{
    "to": "+31612345678",
    "from": "whatsapp",
    "type": "text",
    "content": {
      "text": "John Doe"
    },
    "template_uuid": "d980fb66fd5043d3ace1aa06ba044342",
    "optin_contact": true
  }`)
    req, err := http.NewRequest("POST", "https://api.callbell.eu/v1/messages/send", data)
    if err != nil {
        log.Fatal(err)
    }
    req.Header.Set("Authorization", "Bearer test_gshuPaZoeEG6ovbc8M79w0QyM")
    req.Header.Set("Content-Type", "application/json")
    resp, err := client.Do(req)
    if err != nil {
        log.Fatal(err)
    }
    defer resp.Body.Close()
    bodyText, err := io.ReadAll(resp.Body)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Printf("%s\n", bodyText)
}

PHP

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.callbell.eu/v1/messages/send');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, "{\n    \"to\": \"+31612345678\",\n    \"from\": \"whatsapp\",\n    \"type\": \"text\",\n    \"content\": {\n      \"text\": \"John Doe\"\n    },\n    \"template_uuid\": \"d980fb66fd5043d3ace1aa06ba044342\",\n    \"optin_contact\": true\n  }");

$response = curl_exec($ch);

curl_close($ch);

Python

import requests

headers = {
    'Authorization': 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
    'Content-Type': 'application/json',
}

json_data = {
    'to': '+31612345678',
    'from': 'whatsapp',
    'type': 'text',
    'content': {
        'text': 'John Doe',
    },
    'template_uuid': 'd980fb66fd5043d3ace1aa06ba044342',
    'optin_contact': True,
}

response = requests.post('https://api.callbell.eu/v1/messages/send', headers=headers, json=json_data)

# Note: json_data will not be serialized by requests
# exactly as it was in the original request.
#data = '{\n    "to": "+31612345678",\n    "from": "whatsapp",\n    "type": "text",\n    "content": {\n      "text": "John Doe"\n    },\n    "template_uuid": "d980fb66fd5043d3ace1aa06ba044342",\n    "optin_contact": true\n  }'
#response = requests.post('https://api.callbell.eu/v1/messages/send', headers=headers, data=data)

In this context text refers to the placeholder of the template message, for example let's say you have a template message like this:

template_example

Hello {{1}}, this is a template message example

The placeholder replacement will be done with the value passed in the payload, so in this case it will be the following:

template_example

Hello John Doe, this is a template message example

Send Multi-variables Template Messages

You can use the API to send an approved Template Message.

info

This is only available for accounts using the official WhatsApp Business API integration.

caution

In order to send template messages template_uuid and optin_contact must be present in the payload.

cURL

curl -X POST "https://api.callbell.eu/v1/messages/send" \
  -H "Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+31612345678",
    "from": "whatsapp",
    "type": "text",
    "content": {
      "text": "John Doe"
    },
    "template_values": ["Jack", "template", "Cheers"],
    "template_uuid": "d980fb66fd5043d3ace1aa06ba044342",
    "optin_contact": true
  }'

Node

import axios from 'axios';

const response = await axios.post(
  'https://api.callbell.eu/v1/messages/send',
  // '{\n    "to": "+31612345678",\n    "from": "whatsapp",\n    "type": "text",\n    "content": {\n      "text": "John Doe"\n    },\n    "template_values": ["Jack", "template", "Cheers"],\n    "template_uuid": "d980fb66fd5043d3ace1aa06ba044342",\n    "optin_contact": true\n  }',
  {
    'to': '+31612345678',
    'from': 'whatsapp',
    'type': 'text',
    'content': {
      'text': 'John Doe'
    },
    'template_values': [
      'Jack',
      'template',
      'Cheers'
    ],
    'template_uuid': 'd980fb66fd5043d3ace1aa06ba044342',
    'optin_contact': true
  },
  {
    headers: {
      'Authorization': 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
      'Content-Type': 'application/json'
    }
  }
);

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.callbell.eu/v1/messages/send')
req = Net::HTTP::Post.new(uri)
req.content_type = 'application/json'
req['Authorization'] = 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM'

# The object won't be serialized exactly like this
# req.body = "{\n    \"to\": \"+31612345678\",\n    \"from\": \"whatsapp\",\n    \"type\": \"text\",\n    \"content\": {\n      \"text\": \"John Doe\"\n    },\n    \"template_values\": [\"Jack\", \"template\", \"Cheers\"],\n    \"template_uuid\": \"d980fb66fd5043d3ace1aa06ba044342\",\n    \"optin_contact\": true\n  }"
req.body = {
  'to' => '+31612345678',
  'from' => 'whatsapp',
  'type' => 'text',
  'content' => {
    'text' => 'John Doe'
  },
  'template_values' => [
    'Jack',
    'template',
    'Cheers'
  ],
  'template_uuid' => 'd980fb66fd5043d3ace1aa06ba044342',
  'optin_contact' => true
}.to_json

req_options = {
  use_ssl: uri.scheme == 'https'
}
res = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
  http.request(req)
end

Go

package main

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

func main() {
    client := &http.Client{}
    var data = strings.NewReader(`{
    "to": "+31612345678",
    "from": "whatsapp",
    "type": "text",
    "content": {
      "text": "John Doe"
    },
    "template_values": ["Jack", "template", "Cheers"],
    "template_uuid": "d980fb66fd5043d3ace1aa06ba044342",
    "optin_contact": true
  }`)
    req, err := http.NewRequest("POST", "https://api.callbell.eu/v1/messages/send", data)
    if err != nil {
        log.Fatal(err)
    }
    req.Header.Set("Authorization", "Bearer test_gshuPaZoeEG6ovbc8M79w0QyM")
    req.Header.Set("Content-Type", "application/json")
    resp, err := client.Do(req)
    if err != nil {
        log.Fatal(err)
    }
    defer resp.Body.Close()
    bodyText, err := io.ReadAll(resp.Body)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Printf("%s\n", bodyText)
}

PHP

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.callbell.eu/v1/messages/send');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, "{\n    \"to\": \"+31612345678\",\n    \"from\": \"whatsapp\",\n    \"type\": \"text\",\n    \"content\": {\n      \"text\": \"John Doe\"\n    },\n    \"template_values\": [\"Jack\", \"template\", \"Cheers\"],\n    \"template_uuid\": \"d980fb66fd5043d3ace1aa06ba044342\",\n    \"optin_contact\": true\n  }");

$response = curl_exec($ch);

curl_close($ch);

Python

import requests

headers = {
    'Authorization': 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
    'Content-Type': 'application/json',
}

json_data = {
    'to': '+31612345678',
    'from': 'whatsapp',
    'type': 'text',
    'content': {
        'text': 'John Doe',
    },
    'template_values': [
        'Jack',
        'template',
        'Cheers',
    ],
    'template_uuid': 'd980fb66fd5043d3ace1aa06ba044342',
    'optin_contact': True,
}

response = requests.post('https://api.callbell.eu/v1/messages/send', headers=headers, json=json_data)

# Note: json_data will not be serialized by requests
# exactly as it was in the original request.
#data = '{\n    "to": "+31612345678",\n    "from": "whatsapp",\n    "type": "text",\n    "content": {\n      "text": "John Doe"\n    },\n    "template_values": ["Jack", "template", "Cheers"],\n    "template_uuid": "d980fb66fd5043d3ace1aa06ba044342",\n    "optin_contact": true\n  }'
#response = requests.post('https://api.callbell.eu/v1/messages/send', headers=headers, data=data)

In this context template_values refers to the placeholders of the template message, for example let's say you have a template message like this:

template_example

Hello {{1}}, this is a template {{2}} example. {{3}}!

The placeholders replacements will be done with the values passed in the payload inside an array, so in this case it will be the following:

template_example

Hello Jack, this is a template message example. Cheers!

info

When template_values are valid, the values inside content will be ignored, since it is used for template messages with only one variable.

Send Template Messages with Media Attachments

You can use the API to send an approved Template Message

info

This is only available for accounts using the official WhatsApp Business API integration.

caution

In order to send template messages template_uuid and optin_contact must be present in the payload.

If you have media template messages approved, you can send them by including a valid url of the media

Send Image Attachment

cURL

curl -X POST "https://api.callbell.eu/v1/messages/send" \
  -H "Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+31612345678",
    "from": "whatsapp",
    "type": "image",
    "content": {
      "text": "John Doe",
      "url": "https://example.com/valid_image.jpeg"
    },
    "template_uuid": "d980fb66fd5043d3ace1aa06ba044342",
    "optin_contact": true
  }'

Node

import axios from 'axios';

const response = await axios.post(
  'https://api.callbell.eu/v1/messages/send',
  // '{\n    "to": "+31612345678",\n    "from": "whatsapp",\n    "type": "image",\n    "content": {\n      "text": "John Doe",\n      "url": "https://example.com/valid_image.jpeg"\n    },\n    "template_uuid": "d980fb66fd5043d3ace1aa06ba044342",\n    "optin_contact": true\n  }',
  {
    'to': '+31612345678',
    'from': 'whatsapp',
    'type': 'image',
    'content': {
      'text': 'John Doe',
      'url': 'https://example.com/valid_image.jpeg'
    },
    'template_uuid': 'd980fb66fd5043d3ace1aa06ba044342',
    'optin_contact': true
  },
  {
    headers: {
      'Authorization': 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
      'Content-Type': 'application/json'
    }
  }
);

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.callbell.eu/v1/messages/send')
req = Net::HTTP::Post.new(uri)
req.content_type = 'application/json'
req['Authorization'] = 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM'

# The object won't be serialized exactly like this
# req.body = "{\n    \"to\": \"+31612345678\",\n    \"from\": \"whatsapp\",\n    \"type\": \"image\",\n    \"content\": {\n      \"text\": \"John Doe\",\n      \"url\": \"https://example.com/valid_image.jpeg\"\n    },\n    \"template_uuid\": \"d980fb66fd5043d3ace1aa06ba044342\",\n    \"optin_contact\": true\n  }"
req.body = {
  'to' => '+31612345678',
  'from' => 'whatsapp',
  'type' => 'image',
  'content' => {
    'text' => 'John Doe',
    'url' => 'https://example.com/valid_image.jpeg'
  },
  'template_uuid' => 'd980fb66fd5043d3ace1aa06ba044342',
  'optin_contact' => true
}.to_json

req_options = {
  use_ssl: uri.scheme == 'https'
}
res = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
  http.request(req)
end

Go

package main

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

func main() {
    client := &http.Client{}
    var data = strings.NewReader(`{
    "to": "+31612345678",
    "from": "whatsapp",
    "type": "image",
    "content": {
      "text": "John Doe",
      "url": "https://example.com/valid_image.jpeg"
    },
    "template_uuid": "d980fb66fd5043d3ace1aa06ba044342",
    "optin_contact": true
  }`)
    req, err := http.NewRequest("POST", "https://api.callbell.eu/v1/messages/send", data)
    if err != nil {
        log.Fatal(err)
    }
    req.Header.Set("Authorization", "Bearer test_gshuPaZoeEG6ovbc8M79w0QyM")
    req.Header.Set("Content-Type", "application/json")
    resp, err := client.Do(req)
    if err != nil {
        log.Fatal(err)
    }
    defer resp.Body.Close()
    bodyText, err := io.ReadAll(resp.Body)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Printf("%s\n", bodyText)
}

PHP

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.callbell.eu/v1/messages/send');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, "{\n    \"to\": \"+31612345678\",\n    \"from\": \"whatsapp\",\n    \"type\": \"image\",\n    \"content\": {\n      \"text\": \"John Doe\",\n      \"url\": \"https://example.com/valid_image.jpeg\"\n    },\n    \"template_uuid\": \"d980fb66fd5043d3ace1aa06ba044342\",\n    \"optin_contact\": true\n  }");

$response = curl_exec($ch);

curl_close($ch);

Python

import requests

headers = {
    'Authorization': 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
    'Content-Type': 'application/json',
}

json_data = {
    'to': '+31612345678',
    'from': 'whatsapp',
    'type': 'image',
    'content': {
        'text': 'John Doe',
        'url': 'https://example.com/valid_image.jpeg',
    },
    'template_uuid': 'd980fb66fd5043d3ace1aa06ba044342',
    'optin_contact': True,
}

response = requests.post('https://api.callbell.eu/v1/messages/send', headers=headers, json=json_data)

# Note: json_data will not be serialized by requests
# exactly as it was in the original request.
#data = '{\n    "to": "+31612345678",\n    "from": "whatsapp",\n    "type": "image",\n    "content": {\n      "text": "John Doe",\n      "url": "https://example.com/valid_image.jpeg"\n    },\n    "template_uuid": "d980fb66fd5043d3ace1aa06ba044342",\n    "optin_contact": true\n  }'
#response = requests.post('https://api.callbell.eu/v1/messages/send', headers=headers, data=data)

Send Document Attachment

cURL

curl -X POST "https://api.callbell.eu/v1/messages/send" \
  -H "Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+31612345678",
    "from": "whatsapp",
    "type": "document",
    "content": {
      "text": "John Doe",
      "url": "https://example.com/valid_document.pdf"
    },
    "template_uuid": "d980fb66fd5043d3ace1aa06ba044342",
    "optin_contact": true
  }'

Node

import axios from 'axios';

const response = await axios.post(
  'https://api.callbell.eu/v1/messages/send',
  // '{\n    "to": "+31612345678",\n    "from": "whatsapp",\n    "type": "document",\n    "content": {\n      "text": "John Doe",\n      "url": "https://example.com/valid_document.pdf"\n    },\n    "template_uuid": "d980fb66fd5043d3ace1aa06ba044342",\n    "optin_contact": true\n  }',
  {
    'to': '+31612345678',
    'from': 'whatsapp',
    'type': 'document',
    'content': {
      'text': 'John Doe',
      'url': 'https://example.com/valid_document.pdf'
    },
    'template_uuid': 'd980fb66fd5043d3ace1aa06ba044342',
    'optin_contact': true
  },
  {
    headers: {
      'Authorization': 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
      'Content-Type': 'application/json'
    }
  }
);

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.callbell.eu/v1/messages/send')
req = Net::HTTP::Post.new(uri)
req.content_type = 'application/json'
req['Authorization'] = 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM'

# The object won't be serialized exactly like this
# req.body = "{\n    \"to\": \"+31612345678\",\n    \"from\": \"whatsapp\",\n    \"type\": \"document\",\n    \"content\": {\n      \"text\": \"John Doe\",\n      \"url\": \"https://example.com/valid_document.pdf\"\n    },\n    \"template_uuid\": \"d980fb66fd5043d3ace1aa06ba044342\",\n    \"optin_contact\": true\n  }"
req.body = {
  'to' => '+31612345678',
  'from' => 'whatsapp',
  'type' => 'document',
  'content' => {
    'text' => 'John Doe',
    'url' => 'https://example.com/valid_document.pdf'
  },
  'template_uuid' => 'd980fb66fd5043d3ace1aa06ba044342',
  'optin_contact' => true
}.to_json

req_options = {
  use_ssl: uri.scheme == 'https'
}
res = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
  http.request(req)
end

Go

package main

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

func main() {
    client := &http.Client{}
    var data = strings.NewReader(`{
    "to": "+31612345678",
    "from": "whatsapp",
    "type": "document",
    "content": {
      "text": "John Doe",
      "url": "https://example.com/valid_document.pdf"
    },
    "template_uuid": "d980fb66fd5043d3ace1aa06ba044342",
    "optin_contact": true
  }`)
    req, err := http.NewRequest("POST", "https://api.callbell.eu/v1/messages/send", data)
    if err != nil {
        log.Fatal(err)
    }
    req.Header.Set("Authorization", "Bearer test_gshuPaZoeEG6ovbc8M79w0QyM")
    req.Header.Set("Content-Type", "application/json")
    resp, err := client.Do(req)
    if err != nil {
        log.Fatal(err)
    }
    defer resp.Body.Close()
    bodyText, err := io.ReadAll(resp.Body)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Printf("%s\n", bodyText)
}

PHP

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.callbell.eu/v1/messages/send');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, "{\n    \"to\": \"+31612345678\",\n    \"from\": \"whatsapp\",\n    \"type\": \"document\",\n    \"content\": {\n      \"text\": \"John Doe\",\n      \"url\": \"https://example.com/valid_document.pdf\"\n    },\n    \"template_uuid\": \"d980fb66fd5043d3ace1aa06ba044342\",\n    \"optin_contact\": true\n  }");

$response = curl_exec($ch);

curl_close($ch);

Python

import requests

headers = {
    'Authorization': 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
    'Content-Type': 'application/json',
}

json_data = {
    'to': '+31612345678',
    'from': 'whatsapp',
    'type': 'document',
    'content': {
        'text': 'John Doe',
        'url': 'https://example.com/valid_document.pdf',
    },
    'template_uuid': 'd980fb66fd5043d3ace1aa06ba044342',
    'optin_contact': True,
}

response = requests.post('https://api.callbell.eu/v1/messages/send', headers=headers, json=json_data)

# Note: json_data will not be serialized by requests
# exactly as it was in the original request.
#data = '{\n    "to": "+31612345678",\n    "from": "whatsapp",\n    "type": "document",\n    "content": {\n      "text": "John Doe",\n      "url": "https://example.com/valid_document.pdf"\n    },\n    "template_uuid": "d980fb66fd5043d3ace1aa06ba044342",\n    "optin_contact": true\n  }'
#response = requests.post('https://api.callbell.eu/v1/messages/send', headers=headers, data=data)

Send Video Attachment

cURL

curl -X POST "https://api.callbell.eu/v1/messages/send" \
  -H "Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+31612345678",
    "from": "whatsapp",
    "type": "video",
    "content": {
      "text": "John Doe",
      "url": "https://example.com/valid_video.mp4"
    },
    "template_uuid": "d980fb66fd5043d3ace1aa06ba044342",
    "optin_contact": true
  }'

Node

import axios from 'axios';

const response = await axios.post(
  'https://api.callbell.eu/v1/messages/send',
  // '{\n    "to": "+31612345678",\n    "from": "whatsapp",\n    "type": "video",\n    "content": {\n      "text": "John Doe",\n      "url": "https://example.com/valid_video.mp4"\n    },\n    "template_uuid": "d980fb66fd5043d3ace1aa06ba044342",\n    "optin_contact": true\n  }',
  {
    'to': '+31612345678',
    'from': 'whatsapp',
    'type': 'video',
    'content': {
      'text': 'John Doe',
      'url': 'https://example.com/valid_video.mp4'
    },
    'template_uuid': 'd980fb66fd5043d3ace1aa06ba044342',
    'optin_contact': true
  },
  {
    headers: {
      'Authorization': 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
      'Content-Type': 'application/json'
    }
  }
);

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.callbell.eu/v1/messages/send')
req = Net::HTTP::Post.new(uri)
req.content_type = 'application/json'
req['Authorization'] = 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM'

# The object won't be serialized exactly like this
# req.body = "{\n    \"to\": \"+31612345678\",\n    \"from\": \"whatsapp\",\n    \"type\": \"video\",\n    \"content\": {\n      \"text\": \"John Doe\",\n      \"url\": \"https://example.com/valid_video.mp4\"\n    },\n    \"template_uuid\": \"d980fb66fd5043d3ace1aa06ba044342\",\n    \"optin_contact\": true\n  }"
req.body = {
  'to' => '+31612345678',
  'from' => 'whatsapp',
  'type' => 'video',
  'content' => {
    'text' => 'John Doe',
    'url' => 'https://example.com/valid_video.mp4'
  },
  'template_uuid' => 'd980fb66fd5043d3ace1aa06ba044342',
  'optin_contact' => true
}.to_json

req_options = {
  use_ssl: uri.scheme == 'https'
}
res = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
  http.request(req)
end

Go

package main

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

func main() {
    client := &http.Client{}
    var data = strings.NewReader(`{
    "to": "+31612345678",
    "from": "whatsapp",
    "type": "video",
    "content": {
      "text": "John Doe",
      "url": "https://example.com/valid_video.mp4"
    },
    "template_uuid": "d980fb66fd5043d3ace1aa06ba044342",
    "optin_contact": true
  }`)
    req, err := http.NewRequest("POST", "https://api.callbell.eu/v1/messages/send", data)
    if err != nil {
        log.Fatal(err)
    }
    req.Header.Set("Authorization", "Bearer test_gshuPaZoeEG6ovbc8M79w0QyM")
    req.Header.Set("Content-Type", "application/json")
    resp, err := client.Do(req)
    if err != nil {
        log.Fatal(err)
    }
    defer resp.Body.Close()
    bodyText, err := io.ReadAll(resp.Body)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Printf("%s\n", bodyText)
}

PHP

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.callbell.eu/v1/messages/send');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, "{\n    \"to\": \"+31612345678\",\n    \"from\": \"whatsapp\",\n    \"type\": \"video\",\n    \"content\": {\n      \"text\": \"John Doe\",\n      \"url\": \"https://example.com/valid_video.mp4\"\n    },\n    \"template_uuid\": \"d980fb66fd5043d3ace1aa06ba044342\",\n    \"optin_contact\": true\n  }");

$response = curl_exec($ch);

curl_close($ch);

Python

import requests

headers = {
    'Authorization': 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
    'Content-Type': 'application/json',
}

json_data = {
    'to': '+31612345678',
    'from': 'whatsapp',
    'type': 'video',
    'content': {
        'text': 'John Doe',
        'url': 'https://example.com/valid_video.mp4',
    },
    'template_uuid': 'd980fb66fd5043d3ace1aa06ba044342',
    'optin_contact': True,
}

response = requests.post('https://api.callbell.eu/v1/messages/send', headers=headers, json=json_data)

# Note: json_data will not be serialized by requests
# exactly as it was in the original request.
#data = '{\n    "to": "+31612345678",\n    "from": "whatsapp",\n    "type": "video",\n    "content": {\n      "text": "John Doe",\n      "url": "https://example.com/valid_video.mp4"\n    },\n    "template_uuid": "d980fb66fd5043d3ace1aa06ba044342",\n    "optin_contact": true\n  }'
#response = requests.post('https://api.callbell.eu/v1/messages/send', headers=headers, data=data)

info

Use the Templates API to the get the template_uuids your templates.