Python SDK

pip install zavu
# or
poetry add zavu

from zavu import Zavu
import os

zavu = Zavu(os.environ['ZAVU_API_KEY'])

# Send a message
message = zavu.messages.send(
    to='+56912345678',
    text='Hello from Zavu!'
)

print(f'Message sent: {message.id}')

from zavu import Zavu

# Basic initialization
zavu = Zavu('zv_live_xxx')

# With options
zavu = Zavu(
    api_key='zv_live_xxx',
    base_url='https://api.zavu.dev',  # Custom API URL
    timeout=30.0                       # Request timeout in seconds
)

import os
from zavu import Zavu

zavu = Zavu(os.environ['ZAVU_API_KEY'])

message = zavu.messages.send(
    to='+56912345678',
    text='Your verification code is 123456',
    channel='sms',  # optional: sms, whatsapp, auto
    metadata={      # optional: custom data
        'userId': 'user_123'
    },
    idempotency_key='unique-key'  # optional: prevent duplicates
)

print(message.id)      # msg_xxx
print(message.status)  # queued

message = zavu.messages.send(
    to='+56912345678',
    template_id='tpl_abc123',
    data={
        'customerName': 'John',
        'orderId': '12345'
    }
)

message = zavu.messages.get('msg_abc123')

print(message.status)  # queued, sending, delivered, failed

# List all messages
result = zavu.messages.list()
for message in result.items:
    print(message.id)

# With filters
result = zavu.messages.list(
    status='delivered',
    channel='sms',
    limit=100
)

# Pagination
cursor = None
while True:
    result = zavu.messages.list(cursor=cursor, limit=50)
    for message in result.items:
        print(message.id)
    cursor = result.next_cursor
    if not cursor:
        break

template = zavu.templates.create(
    name='order_confirmation',
    category='transactional',
    body='Hi {{name}}, your order #{{orderId}} is confirmed!'
)

result = zavu.templates.list()
for template in result.items:
    print(template.name)

template = zavu.templates.get('tpl_abc123')

template = zavu.templates.update(
    'tpl_abc123',
    body='Hi {{name}}, order #{{orderId}} confirmed! Delivery: {{date}}'
)

zavu.templates.delete('tpl_abc123')

result = zavu.senders.list()
for sender in result.items:
    print(sender.name)

sender = zavu.senders.create(
    name='Marketing',
    routing_policy='prefer_whatsapp',
    channels={
        'sms': {'phoneNumber': '+15551234567'},
        'whatsapp': {'phoneNumber': '+15551234567'}
    },
    set_as_default=True
)

contact = zavu.contacts.get('con_abc123')
# or by phone
contact = zavu.contacts.get_by_phone('+56912345678')

contact = zavu.contacts.update(
    'con_abc123',
    default_channel='whatsapp',
    metadata={
        'name': 'John Doe',
        'tier': 'premium'
    }
)

from zavu import Zavu
from zavu.exceptions import ZavuError, BadRequestError, UnauthorizedError

try:
    zavu.messages.send(
        to='invalid-number',
        text='Hello'
    )
except BadRequestError as e:
    print(f'Bad request: {e.message}')
except UnauthorizedError as e:
    print(f'Auth error: {e.message}')
except ZavuError as e:
    print(f'API error: {e.code} - {e.message}')

import asyncio
from zavu import AsyncZavu

async def main():
    zavu = AsyncZavu(os.environ['ZAVU_API_KEY'])

    message = await zavu.messages.send(
        to='+56912345678',
        text='Hello async!'
    )

    print(f'Message sent: {message.id}')

asyncio.run(main())

async with AsyncZavu(api_key) as zavu:
    message = await zavu.messages.send(
        to='+56912345678',
        text='Hello!'
    )

from zavu import Zavu
from zavu.types import Message, Template, SendMessageRequest

zavu: Zavu = Zavu(api_key)

request: SendMessageRequest = {
    'to': '+56912345678',
    'text': 'Hello!'
}

message: Message = zavu.messages.send(**request)

import logging

logging.basicConfig(level=logging.DEBUG)

# Or just for zavu
logging.getLogger('zavu').setLevel(logging.DEBUG)