Skip to content

Developers

Every message, lead and event — in your systems too

A JSON:API over HTTPS, signed webhooks per number, and a public capture endpoint for your website forms. The same API the apps use.

A JSON:API request sending a WhatsApp message through Haiya, the message in a chat, and the reply returned as a signed webhook
http
# Forward every inbound message
POST https://your.app/haiya
X-Haiya-Signature-256: sha256=9f2a…

{ "type": "message.received",
  "from": "+254 712 345 678",
  "text": "Is the 2-bed still available?" }

What you can build

Four ways in

  • REST API

    Endpoints for conversations, persons, leads, broadcasts, templates and team.

  • Webhooks

    Per-number forwarding of message and status events. Signed per attempt, retried for up to 7 days. Business events — lead created, lead stage changed, lead owner assigned, request opened or changed, payment received, order placed, form completed — from Settings → Integrations → Webhooks & events.

  • Lead capture

    One token, one POST. Website forms, Zapier, Make — straight into the pipeline.

  • Auth & scopes

    Session tokens for people, capture tokens for systems. Each route checks the caller’s permissions and refuses anything not allowed.

Reference

A few of the endpoints

Base URL https://api.haiya.co. JSON:API request and response bodies (application/vnd.api+json).

  • GET/conversationsList, filter by number, status, owner
  • GET/conversations/{id}/chatsMessages in a conversation, cursor-paged
  • POST/conversations/{id}/chatsSend text, media or a template
  • PATCH/conversations/{id}Archive, mute, mark read
  • POST/persons/{id}/ownershipAssign or offer a customer to a member
  • POST/capture/leadsCreate a lead from any system
  • GET/plansThe plan catalogue, the same plans as the pricing page

Your customers are already on WhatsApp.

Connect your number in minutes. Invite your team in one more.

“…we use Haiya every day, and it has made team communication much easier.”

James Mwangi, Zinen TechnologiesTrustpilot