One wire to every customer

Send business messages over WhatsApp, Telegram, SMS and Beep Call through a single API. One request, one format, one status model.

Get sandbox key
  • 1

    endpoint

    POST /v1/messages — one message format for every channel.

  • 4

    channels

    WhatsApp, Telegram, SMS and Beep Call behind the same request.

  • 5

    statuses

    queued → sent → delivered → read → failed. Identical webhooks on every channel.

Your customers are split across WhatsApp, Telegram and plain SMS. Every channel is its own integration, with its own account, templates, API format and status rules, and every new market multiplies the work. Pricing changes from channel to channel. Fivv is one wire: one request in, the right channel out, every status reported the same way.

Channels

Four channels.
One request.

  1. WhatsApp

    Order and delivery updates, reminders and two-way conversations on the messenger many customers already use.

  2. Telegram

    Verification codes and transactional alerts through the Telegram Bot API.

  3. SMS

    Plain text to any mobile number, for customers who are not on a messenger.

  4. Beep Call

    A short ring or voice drop to a phone number when a chat message is not delivered or read in time. No app needed.

What your customers see, and what your team sees

Your team One log for every message, on every channel

Example message log with one status model across channels
UpdatedRecipientChannelStatusRouteTemplate
10:14:31+44 7700 900•23WhatsAppreadWhatsApporder_update

msg_01JD8Q3W7Korder_update · en_GB

  1. queued10:12:04
  2. sent10:12:04
  3. delivered10:12:06
  4. read10:14:31
10:14:12+44 7700 900•18TelegramdeliveredTelegramlogin_code
10:13:58+44 7700 900•77SMSdeliveredWhatsAppSMSappointment_reminder
10:13:40+44 7700 900•56Beep CallsentWhatsAppBeep Calldelivery_unread
10:13:22+44 7700 900•09WhatsAppdeliveredWhatsApporder_update
10:13:05+44 7700 900•41SMSfailedTelegramSMSlogin_code
10:12:51+44 7700 900•62TelegramreadTelegramlogin_code
10:12:37+44 7700 900•94WhatsAppqueuedWhatsApporder_update
10:12:20+44 7700 900•35SMSsentSMSappointment_reminder
10:12:02+44 7700 900•88WhatsAppreadWhatsApporder_update
10:11:47+44 7700 900•12TelegramdeliveredTelegramlogin_code
10:11:30+44 7700 900•70Beep CalldeliveredWhatsAppBeep Calldelivery_unread
Dashboard: a message log where every channel reports the same five statuses.
1POST https://api.fivv.dev/v1/messages
2Authorization: Bearer $FIVV_API_KEY
3Content-Type: application/json
4
5{
6  "to": "+447700900123",
7  "text": "Your order #4821 is on its way.",
8  "fallback": ["whatsapp", "telegram",
9               "sms", "beep"]
10}

Response202 Accepted

{ "id": "msg_01JD8Q3W7K", "status": "queued" }
One request to POST /v1/messages with a fallback order.

Your customers The message arrives on the channel that reaches them

Wednesday 18 November

9:41

  • Acme PaynowYour login code is 482 913. Valid for 5 minutes. Never share this code.
  • ACME CLINIC2m agoReminder: appointment tomorrow at 09:30. Reply 1 to confirm.
Lock screen with a Telegram login code and an SMS appointment reminder.

Today

Hi! Any update on order #4821?09:58

Your order #4821 is on its way Hi Sara, the courier will arrive today between 14:30 and 15:00. Track the parcel or pick another time. Sent via Fivv10:12 Track order Change time

Great, thanks! Please leave it with the concierge.10:14

Delivered. Your parcel was left with the concierge at 14:41. Thanks for shopping with Acme.14:41

Business chat: an order template with reply buttons, a customer reply and a delivery confirmation.

Beep Call

Acme Delivery

Beep Call · about your unread message

0:08

“Your courier is outside. Details are in your WhatsApp chat.”

Beep Call: an incoming call from Acme Delivery with a short voice-drop transcript.

Interface examples. Names and numbers are illustrative.

How it works

Send once.
We carry it the rest of the way.

  1. 01

    Send once

    Post one message to /v1/messages with the recipient, the content and the order of channels to try.

  2. 02

    Fivv routes

    The message goes out on the first channel in your list. If that channel can’t deliver, Fivv moves to the next one.

  3. 03

    Status webhooks

    queued, sent, delivered, read, failed. Your webhook gets the same payload fields whichever channel carried the message.

  4. 04

    Beep Call escalation

    If a chat message isn’t delivered or read within the window you set, Fivv places a short ring or voice drop to the customer’s phone.

Use cases

Built for messages that have to arrive.

Operational, transactional and time-critical messages, not marketing blasts.

Use case Channels Typical sender What it changes
Order and delivery updates WhatsApp E-commerce, logistics Fewer “where is my order” support contacts
Verification codes and alerts TelegramBeep Call fallback Fintech, SaaS Faster confirmation and higher login conversion
Appointment and payment reminders WhatsAppBeep Call escalation Clinics, service companies, utilities Fewer missed appointments and late payments
Two-way conversations WhatsAppTelegram Support teams One threaded conversation per customer across channels
Critical alerts when chat is unread Beep Call Any operations team An attention channel that works without installing an app

Developers

Your first message, minutes after sign-up.

Self-service sandbox, executable docs and SDKs. No sales call before you can send.

  • SandboxTest volume with no delivery to real recipients.
  • API keysAuthenticate every request with your account key.
  • SDKsClient libraries over the same REST endpoint.
  • WebhooksOne status payload for every channel.
  • DashboardMessage log, status search, templates and usage.
curl https://api.fivv.dev/v1/messages \
  -H "Authorization: Bearer $FIVV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+447700900123",
    "text": "Your order #4821 is on its way.",
    "fallback": ["whatsapp", "telegram", "sms", "beep"]
  }'

Webhook · read

{ "id": "msg_8f2c…", "channel": "whatsapp",
  "status": "read", "error": null }

Vision

Any business message, delivered worldwide through one wire.

Pricing

You pay per message.

Each message is priced as the channel cost, passed through at the actual rate, plus a Fivv platform margin. Balances are prepaid in credits. The API is the same on every plan.

Plan terms are being finalised with design partners.

Let’s connect

Become a design partner.

We are shaping Fivv with a small group of teams in e-commerce, logistics, fintech and SaaS. Tell us what you send and where your customers are.

hello@fivv.dev