Skip to main content

unlimited-messaging

Official Python client for the Unlimited Messaging API — send and receive WhatsApp messages programmatically.

PyPI version PyPI downloads PyPI total downloads Python versions License CI

Installation

pip install unlimited-messaging

Quick start

import os
from unlimited_messaging import UnlimitedMessagingApi

client = UnlimitedMessagingApi(
    token=os.environ["API_TOKEN"],
)

# Send a WhatsApp message
message = client.message.send(
    recipient="+33612345678",
    text="Hello!",
)

print(message.id, message.status)

Authentication

Get your API token from the dashboard and pass it as the token argument.

client = UnlimitedMessagingApi(token="your_api_token")

Examples

Send a message

message = client.message.send(
    recipient="+33612345678",
    text="Hello from the SDK!",
    sim_id="optional-sim-id",  # force a specific SIM
)

List messages

result = client.message.find_all(
    page=1,
    limit=20,
    status="DELIVERED",   # PENDING | SENDING | SENT | DELIVERED | READ | FAILED
    search="keyword",
)

print(f"{result.total} messages")
for msg in result.data:
    print(msg.id, msg.status, msg.text)

Get a single message

msg = client.message.find_one("message-id")
print(msg.id, msg.status, msg.text)

List linked SIMs

sims = client.sim.get_linked_sims()

for sim in sims:
    print(sim.id, sim.phone_number)

Async support

import asyncio
from unlimited_messaging import AsyncUnlimitedMessagingApi

client = AsyncUnlimitedMessagingApi(token="your_api_token")

async def main():
    message = await client.message.send(
        recipient="+33612345678",
        text="Hello async!",
    )
    print(message.id, message.status)

asyncio.run(main())

API reference

Method Description
message.send Send a WhatsApp message
message.find_all List messages with pagination and filters
message.find_one Get a single message by ID
sim.get_linked_sims List linked SIMs

Official documentation: docs.unlimitedmessaging.app Full OpenAPI spec: openapi.yaml

Metadata

Release files for unlimited-messaging 0.1.20

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for unlimited-messaging 0.1.20
File Size Uploaded
unlimited_messaging-0.1.20.tar.gz 61.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for unlimited-messaging 0.1.20
File Interpreter ABI Platform
unlimited_messaging-0.1.20-py3-none-any.whl Python 3 none any Details

Total release size: 214.4 kB

Release files / unlimited_messaging-0.1.20.tar.gz

Download URL unlimited_messaging-0.1.20.tar.gz
Size 61.3 kB
Tags Source
SHA-256 checksum
How to use checksums
e4de0bf7592689b1a98724501ba2e80376b9f2ba1e6259909ccaed9f9acfce83
BLAKE2b-256 checksum
How to use checksums
912a2ff15e51523fa2e0f0e6b74ec77fea51de26cd39e49a0d215326854682aa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / unlimited_messaging-0.1.20-py3-none-any.whl

Download URL unlimited_messaging-0.1.20-py3-none-any.whl
Size 153.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d064b03ab9b062d0bbfe5195f79a6c809707148235ba60282ba7953c869e5e24
BLAKE2b-256 checksum
How to use checksums
69749a2975ecf8206f45ee524ccb898bb5d647fcdc775534f90faa63e4dace15
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release history Release notifications | RSS feed

This release

0.1.20 This release

2 release files

0.1.19

2 release files

0.1.18

2 release files

0.1.17

2 release files

0.1.16

2 release files

0.1.15

2 release files

0.1.14

2 release files

0.1.13

2 release files

0.1.12

2 release files

0.1.10

2 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page