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.
| Language | Package | Install |
|---|---|---|
| Node.js / TypeScript | @splashifypro/sdk | npm install @splashifypro/sdk |
| Python | splashifypro | pip install splashifypro |
| PHP | splashifypro/sdk | composer require splashifypro/sdk |
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-Afterautomatically) - ✓ Consistent error class hierarchy across languages
Why use the SDK?
| Without SDK | With SDK |
|---|---|
| Read 30 docs pages, hand-build curl requests, parse JSON manually | await splashify.messages.sendText({ to, text }) |
| Hard-code API URL versions, break on upgrades | SDK targets a stable API version, follows our compatibility policy |
| Roll your own retry/backoff logic | Built in |
| Manually verify webhook signatures with HMAC | splashify.webhooks.verify(body, headers) |
Quickstart by language
Node.js / 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);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}")PHP
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";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/sdk@1.x↔ 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):
- CI regenerates the OpenAPI spec from annotated handlers
- SDK generators run for all three languages
- Version is bumped (
1.45.0everywhere) - Packages publish automatically to npm, PyPI, Packagist
- 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
| Feature | Splashify Pro | AiSensy | Wati |
|---|---|---|---|
| Official Node SDK | ✓ | ✗ | ✗ |
| Official Python SDK | ✓ | ✗ | ✗ |
| Official PHP SDK | ✓ | ✗ | ✗ |
| Auto-generated from OpenAPI | ✓ | n/a | n/a |
| Type definitions | ✓ | n/a | n/a |
| Webhook signature helpers | ✓ | ✗ | ✗ |
| < 10 LOC quickstart | ✓ | ~30 LOC curl | ~30 LOC curl |
Need help?
- GitHub issues per SDK:
github.com/splashifypro/sdk-node,sdk-python,sdk-php - Email:
support@splashifypro.in - Stack Overflow tag:
splashifypro