Skip to main content
The Linkia Messaging API lets your own systems send and read customer conversations — notify a customer when their ticket closes, pull a thread into your helpdesk, or trigger a WhatsApp template from a workflow you already run. Base URL

​
What you can do

Send a message

Templates, media, or plain text — one endpoint for all three.

Read conversations

List threads and page through their message history.

List templates

See which approved WhatsApp templates a channel can send.

Find your channels

Every other endpoint needs a channelId — this is where you get it.

​
Before your first call

1

Create an API key

In Linkia, go to Settings → API Keys. The key is shown once, at creation — copy it then. Give it only the scopes the integration needs; see Authentication.
2

Find your channel

Call GET /v1/connect/channels. The id of the channel you want to send from is the channelId every other endpoint asks for.
3

Send something

Follow the quickstart to send your first template.

​
The one WhatsApp rule that catches everyone

WhatsApp only lets you send free-form text within 24 hours of the customer’s last message. Outside that window — which is almost always the case for a notification your system initiates — you must send an approved template.
A plain-text send to a customer who hasn’t messaged you recently will be rejected by WhatsApp, not by us. If your integration sends notifications, it should send templates.
Instagram, Messenger and Telegram have their own rules; the same principle applies.

​
Conventions

  • All request and response bodies are JSON.
  • Timestamps are ISO 8601 UTC.
  • IDs are UUIDs unless stated otherwise.
  • Phone numbers are E.164 without a + — 201001234567, never 01001234567.
  • Sends return 202 Accepted: the message is queued, not yet delivered. Track the outcome through the message’s status field.