{"id":50299311,"url":"https://github.com/splashifypro/sdk-python","last_synced_at":"2026-05-28T11:04:19.476Z","repository":{"id":355363591,"uuid":"1227812555","full_name":"splashifypro/sdk-python","owner":"splashifypro","description":null,"archived":false,"fork":false,"pushed_at":"2026-05-26T07:03:08.000Z","size":46,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-26T09:09:16.318Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/splashifypro.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-03T07:39:19.000Z","updated_at":"2026-05-26T07:03:12.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/splashifypro/sdk-python","commit_stats":null,"previous_names":["splashifypro/sdk-python"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/splashifypro/sdk-python","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/splashifypro%2Fsdk-python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/splashifypro%2Fsdk-python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/splashifypro%2Fsdk-python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/splashifypro%2Fsdk-python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/splashifypro","download_url":"https://codeload.github.com/splashifypro/sdk-python/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/splashifypro%2Fsdk-python/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33605450,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-28T02:00:06.440Z","response_time":99,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-28T11:04:18.792Z","updated_at":"2026-05-28T11:04:19.465Z","avatar_url":"https://github.com/splashifypro.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Splashify Pro — Python SDK\n\n[![PyPI](https://img.shields.io/badge/pypi-splashifypro-3776ab?logo=pypi\u0026logoColor=white)](https://pypi.org/project/splashifypro/)\n[![Python](https://img.shields.io/badge/python-3.9%2B-3776ab?logo=python\u0026logoColor=white)](https://pypi.org/project/splashifypro/)\n[![docs](https://img.shields.io/badge/docs-splashifypro.com-1B70FF)](https://docs.splashifypro.com/public-api)\n[![license](https://img.shields.io/badge/license-MIT-22c55e)](./LICENSE)\n\nOfficial Python SDK for the [Splashify Pro](https://splashifypro.com) API —\nsend WhatsApp messages, transactional emails, manage contacts and\nconversations, and fire Meta Conversions events from your Python backend.\n\n## Install\n\n```bash\npip install splashifypro\n```\n\nRequires Python 3.9+.\n\n## Get your API key\n\n1. **Sign in** to your Splashify Pro account at\n   [app.splashifypro.com](https://app.splashifypro.com).\n   No account yet? [Sign up free](https://app.splashifypro.com/auth/signup).\n\n2. Open the **Settings** dialog (gear icon, top right) → click the\n   **Developer** tile.\n   *Direct link:* [app.splashifypro.com/settings/developer](https://app.splashifypro.com/settings/developer)\n\n3. Under **API Keys**, click **Generate Secret Key**.\n\n4. Copy the key shown (starts with `sk_live_…`) and store it somewhere\n   secure — it's shown **only once**. If you lose it, generate a new one\n   and the old one stops working.\n\n5. Use it as the `SPLASHIFY_API_KEY` environment variable in your app.\n   **Never commit it to git or paste it into client-side code** — the\n   key carries full account access.\n\n\u003e **Tip:** Set up a [webhook URL](https://app.splashifypro.com/settings/developer)\n\u003e on the same page to receive delivery / read receipts and inbound message\n\u003e events.\n\n## Authentication\n\nThe SDK uses HTTP Basic with the API key as the username:\n\n```python\nimport os\nfrom splashifypro import Configuration, ApiClient\nfrom splashifypro.api import MessagesApi\n\nconfig = Configuration(username=os.environ[\"SPLASHIFY_API_KEY\"])\nclient = ApiClient(config)\n\nmessages = MessagesApi(client)\n```\n\n## Quickstart — send a WhatsApp text\n\n```python\nresult = messages.public_message_post(\n    body={\n        \"type\": \"Text\",\n        \"countryCode\": \"+91\",\n        \"phoneNumber\": \"9999999999\",\n        \"data\": {\"message\": \"Hi! Thanks for reaching out 👋\"},\n    }\n)\n\nprint(result[\"id\"])  # message_id — use to poll status / correlate webhooks\n```\n\n## Send a WhatsApp template\n\n```python\nmessages.public_message_post(body={\n    \"type\": \"Template\",\n    \"countryCode\": \"+91\",\n    \"phoneNumber\": \"9999999999\",\n    \"template\": {\n        \"name\": \"order_confirmation\",\n        \"languageCode\": \"en\",\n        \"bodyValues\": [\"Sayan\", \"ORD-1042\", \"₹1,499\"],\n        \"buttonValues\": {\"0\": [\"https://shop.example.com/orders/1042\"]},\n    },\n})\n```\n\n## Send a transactional email\n\n\u003e Requires a verified sender domain. Set up at\n\u003e **https://app.splashifypro.com/settings/email-domain**.\n\n```python\nfrom splashifypro.api import EmailApi\n\nemail = EmailApi(client)\n\nemail.public_email_send_post(body={\n    \"to\": \"customer@example.com\",\n    \"subject\": \"Your receipt for Order #1042\",\n    \"html\": \"\u003ch1\u003eThanks!\u003c/h1\u003e\u003cp\u003eOrder #1042 confirmed.\u003c/p\u003e\",\n    \"text\": \"Thanks! Order #1042 confirmed.\",\n    \"from_email\": \"billing@yourdomain.com\",\n    \"from_name\": \"Acme Inc.\",\n})\n```\n\n## Available APIs\n\n| Class                | What it does                                                |\n| -------------------- | ----------------------------------------------------------- |\n| `MessagesApi`        | Send WhatsApp messages (text, template, media, interactive) |\n| `EmailApi`           | Send transactional + templated emails                       |\n| `ContactsApi`        | List + filter contacts                                      |\n| `ConversationsApi`   | Assign chats to team members                                |\n| `MetaConversionsApi` | Fire Meta Pixel / Conversions API events                    |\n\nFull reference, request/response shapes, and per-endpoint examples:\n**https://docs.splashifypro.com/public-api**\n\n## Async usage\n\nThe SDK is sync by default. For async workloads, run synchronous calls in a\nthread pool:\n\n```python\nimport asyncio\n\nresult = await asyncio.to_thread(\n    messages.public_message_post,\n    body={\"type\": \"Text\", \"countryCode\": \"+91\", \"phoneNumber\": \"9999999999\",\n          \"data\": {\"message\": \"Hello!\"}},\n)\n```\n\n## Rate limits\n\nPer-key limits depend on your plan tier. Hitting the limit returns HTTP 429 —\nthe response body includes `Retry-After`. Tier and current consumption are\nvisible at https://app.splashifypro.com/settings/developer.\n\n## Error handling\n\n```python\nfrom splashifypro.exceptions import ApiException\n\ntry:\n    result = messages.public_message_post(body={...})\nexcept ApiException as e:\n    print(f\"HTTP {e.status}: {e.body}\")\n```\n\n## Support\n\n- **Issues / bug reports:** [github.com/splashifypro/sdk-python/issues](https://github.com/splashifypro/sdk-python/issues)\n- **Documentation:** [docs.splashifypro.com/public-api](https://docs.splashifypro.com/public-api)\n- **Email support:** support@splashifypro.in\n\n## License\n\n[MIT](./LICENSE)\n\n---\n\nThis SDK is auto-generated from the official OpenAPI specification. Pull\nrequests for SDK-side improvements (typing, ergonomic wrappers, async\nhelpers, etc.) are welcome; underlying API changes should be filed against\nthe documentation site.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsplashifypro%2Fsdk-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsplashifypro%2Fsdk-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsplashifypro%2Fsdk-python/lists"}