REST API

Secure messaging from external apps

How to Use the API Feature in Botassium

The Botassium API allows you to send WhatsApp messages directly from your own systems using a simple HTTP POST request. Each bot has its own unique API endpoint, which can be found inside the bot’s API settings tab.

With just a few lines of JSON, you can trigger text messages, media, locations, contact cards, polls, and even button list messages from your website, CRM, backend system, or any third-party platform.

What You Can Do With the API

  • Send transactional messages like order confirmations or shipping updates

  • Trigger alerts and reminders from your internal systems

  • Send rich content including documents, images, and locations

  • Fully automate WhatsApp communication from any external app

Supported Message Formats & Examples

Text Message

{
  "action": "send-message",
  "type": "text",
  "content": "Hello, WhatsApp!",
  "phone": "905366365288"
}

Media Message (images, videos, documents, etc.)

{
  "action": "send-message",
  "type": "media",
  "content": "Hello, WhatsApp!",
  "phone": "905366365288",
  "attachments": [
    "https://example.com/file.jpg"
  ]
}

Attachments file names and types are pulled automatically from the attachment link, but if you want to customize it, extend the attachment link into an object with the "url", "type" and "name" parameters, where the "type" is an (image, video, audio, or document):

{
  "action": "send-message",
  "type": "media",
  "content": "Hello, WhatsApp!",
  "phone": "905366365288",
  "attachments": [
    {
      "url": "https://example.com/drive/12EF765HD235LKD.pdf",
      "type": "image",
      "name": "Porfolio.pdf"
    }
  ]
}

Contact Card Message

Sends a contact card. The number field must be in international format.

{
  "action": "send-message",
  "type": "contact",
  "name": "Technical Support",
  "number": "905523909010",
  "organization": "Elbruz Technologies",
  "phone": "905366365288"
}

Location Message

You can use \n in the name field to insert a line break or description.

{
  "action": "send-message",
  "type": "location",
  "name": "Elbruz Technologies\nBuilding A2 IFZA Business Park, Dubai Silicon Oasis, UAE.",
  "lat": "25.119869",
  "lng": "55.386700",
  "phone": "905366365288"
}

Poll Message

You can allow single or multiple selections using the "multiple" field.

{
  "action": "send-message",
  "type": "poll",
  "content": "Please rate our company services.",
  "multiple": false,
  "options": ["Bad", "Good", "Perfect"],
  "phone": "905366365288"
}

Button List Message

Creates an expandable menu of choices with brief descriptions.

{
  "action": "send-message",
  "type": "list",
  "button": "Select Service",
  "header": "Welcome to Elbruz Technologies",
  "content": "Please choose which one of our products are you interested in.",
  "options": [
    {"title": "Botassium", "text": "Our cloud-based WhatsApp automation platform"},
    {"title": "WA Web Plus", "text": "#1 WhatsApp extension"},
    {"title": "WA Toolbox", "text": "Your best WhastApp business partner"},
    {"title": "Triplo AI", "text": "The only AI assistant you'll ever need!"}
  ],
  "phone": "905366365288"
}

Authentication & Endpoint

  • Each bot has a private API endpoint (visible in the API tab under the bot’s settings).

  • Authentication is enforced—make sure your requests are sent securely.

  • Always use HTTP POST method and Content-Type: application/json.

Summary

The Botassium API is a powerful and flexible way to integrate WhatsApp messaging into your existing business systems. From simple text replies to dynamic media and interactive message types, it enables real-time communication at scale—all triggered programmatically with just a few lines of JSON.

Use it to power up your sales funnels, customer service workflows, marketing automations, and internal notifications.

Seamlessly Integrates With Your Favorite Tools

Build powerful chatbots for WhatsApp in just a few clicks.

Get Started Now

Join our email newsletter

Seamlessly Integrates With Your Favorite Tools

Build powerful chatbots for WhatsApp in just a few clicks.

Get Started Now

Join our email newsletter

Seamlessly Integrates With Your Favorite Tools

Build powerful chatbots for WhatsApp in just a few clicks.

Get Started Now

Join our email newsletter