Python SDK

pip install whatsrb-cloud

import whatsrb_cloud

whatsrb_cloud.configure(api_key="wrb_live_xxx")
client = whatsrb_cloud.client()

from whatsrb_cloud import WhatsrbCloud

client = WhatsrbCloud("wrb_live_xxx")

# Create an agent
agent = client.agents.create(
    name="Support Agent",
    system_prompt="Handle customer support requests.",
    allowed_actions=["support.refund.process", "support.ticket.create"],
)

# Run it
run = agent.run(input="I want a refund for order ORD-1234")

run.actions  # [{"type": "support.refund.process", "payload": {"order_id": "ORD-1234"}}]

# Send a message via Business API
account = client.business_accounts.list()[0]
account.send_text(to="+33612345678", text=run.suggested_reply)

from whatsrb_cloud import (
    WhatsrbCloudError,
    AuthenticationError,
    NotFoundError,
    RateLimitError,
    ValidationError,
    ServerError,
)

try:
    account.send_text(to="+33612345678", text="Hello!")
except AuthenticationError as e:
    # Invalid API key
    pass
except NotFoundError as e:
    # Account not found
    pass
except RateLimitError as e:
    print(f"Retry after {e.retry_after}s")
except ValidationError as e:
    # Invalid parameters
    print(e.details)
except ServerError as e:
    # 5xx from the API
    pass
except WhatsrbCloudError as e:
    # Base class for all SDK errors
    pass