Skip to content
Splashify Pro
Docs

Official SDKs

Splashify Pro publishes official SDKs for the three most-used backend languages. Each is auto-generated from our OpenAPI 3.0 spec so they're always in sync with the API — no drift, no out-of-date method signatures.

All SDKs share:

  • ✓ Full type definitions (TypeScript types, Python type hints, PHP PHPDoc)
  • ✓ Async/await primitives idiomatic to each language
  • ✓ Automatic retry on 5xx with exponential backoff
  • ✓ Built-in webhook signature verification helpers
  • ✓ Rate-limit aware (parses Retry-After automatically)
  • ✓ Consistent error class hierarchy across languages

Why use the SDK?

Quickstart by language

Node.js / TypeScript

typescript
import { Splashify } from '@splashifypro/sdk';

const splashify = new Splashify({ apiKey: process.env.SPLASHIFY_API_KEY });

// Send a WhatsApp text message
const result = await splashify.messages.sendText({
  to: '919876543210',
  text: 'Hello from Splashify Pro!',
});

console.log('Sent:', result.messageId);

Full Node.js docs →

Python

python
from splashifypro import Splashify

splashify = Splashify(api_key=os.environ["SPLASHIFY_API_KEY"])

# Send a WhatsApp text message
result = splashify.messages.send_text(
    to="919876543210",
    text="Hello from Splashify Pro!",
)

print(f"Sent: {result.message_id}")

Full Python docs →

PHP

text
use Splashifypro\Splashify;

$splashify = new Splashify(['api_key' => getenv('SPLASHIFY_API_KEY')]);

$result = $splashify->messages->sendText([
    'to' => '919876543210',
    'text' => 'Hello from Splashify Pro!',
]);

echo "Sent: {$result->messageId}\n";

Full PHP docs →

What's in every SDK

All three SDKs cover the full Public API surface:

  • Messaging — sendText, sendTemplate, sendMedia, sendInteractive (button/list/cta_url), sendLocation, sendContact
  • Conversations — list, get, assign, resolve, send read receipts
  • Contacts — create, update, delete, list (filters + pagination), addTags, blockContact
  • Templates — list, sync from Meta, send
  • Broadcasts — create, get, cancel, listMessages, broadcastReport
  • Calling — initiate WhatsApp Business call, listCalls, getCall (with recording URL)
  • Payment Links — create, list, get, cancel, sendReceipt
  • Email — sendEmail, sendTemplateEmail (Splashify Pro email-marketing add-on)
  • Webhooks — verifySignature helper for inbound webhooks
  • Wallet — getWallet, listTransactions

Versioning + backward compatibility

  • SDK major versions track our API major versions (@splashifypro/[email protected] ↔ API v1).
  • Method names + signatures are stable within a major version.
  • New endpoints are added in minor versions (no breaking changes).
  • Removed endpoints get a 6-month deprecation window with a clear console warning.

Auto-publish pipeline

When the backend ships a new release tag (e.g. v1.45.0):

  1. CI regenerates the OpenAPI spec from annotated handlers
  2. SDK generators run for all three languages
  3. Version is bumped (1.45.0 everywhere)
  4. Packages publish automatically to npm, PyPI, Packagist
  5. Changelog gets posted to docs.splashifypro.com/changelog

You'll never have to wait for "the SDK to catch up" — it's literally generated from the same source as the API.

Comparison vs AiSensy / Wati

Need help?

  • GitHub issues per SDK: github.com/splashifypro/sdk-node, sdk-python, sdk-php
  • Email: [email protected]
  • Stack Overflow tag: splashifypro