Skip to main content

WhatsAI by Tisement Media

AIM: A fully deployable AI customer service agent built for small businesses.

Philosophy

Customers want their business on WhatsApp, not just for marketing, but for the actual customer service. Small businesses don't have the staff to answer 24/7. WhatsAI lets small businesses engage leads, answer FAQs, book orders, and handle real conversations inside WhatsApp — all from a live webhook and an LLM backend that Tisement Media can configure per client.

Installation

pip install tisement-agent

Setup

whatsai setup

You'll be prompted for:

  1. LLM provider + API key (OPENAI_API_KEY, ANTHROPIC_API_KEY, or custom endpoint)
  2. WhatsApp Business API credentials (WHATSAPP_PHONE_NUMBER_ID, WHATSAPP_ACCESS_TOKEN)
  3. Optional: Facebook Messenger and Instagram
  4. Client config path

Run Webhook Server

whatsai run --config ./clients/savannah-grill

Test Locally

whatsai chat --config ./clients/savannah-grill

Project Structure

tisement-agent/
  tisement_agent/
    cli/              — Typer CLI entry points
    core/             — Webhook router, LLM client, conversation store
    platforms/        — WhatsApp, Messenger, Instagram adapters
  clients/            — Client configs + KBs (not shipped, user-local)
  tests/

Deployment

The server is a single FastAPI app. Deploy to Fly.io, Railway, Railway, Render, Heroku, or any VPS.

Environment variables for production:

  • WHATSAPP_PHONE_NUMBER_ID
  • WHATSAPP_ACCESS_TOKEN
  • WHATSAPP_WEBHOOK_VERIFY_TOKEN
  • LLM_API_KEY
  • LLM_PROVIDER (openai | anthropic | custom)
  • LLM_MODEL_NAME
  • PORT (auto-set on most platforms)

License

MIT © Tisement Media

Metadata

Release files for tisement-agent 0.2.0

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

Source distribution (sdist)

Source distribution for tisement-agent 0.2.0
File Size Uploaded Provenance Actions
tisement_agent-0.2.0.tar.gz 24.2 kB Without provenance Details for tisement_agent-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for tisement-agent 0.2.0
File Interpreter ABI Platform Actions
tisement_agent-0.2.0-py3-none-any.whl Python 3 none any Details for tisement_agent-0.2.0-py3-none-any.whl

Total release size: 56.5 kB

Release files / tisement_agent-0.2.0.tar.gz

Download URL tisement_agent-0.2.0.tar.gz
Size 24.2 kB
Tags Source
SHA-256 checksum
How to use checksums
b72223fd493c305bbd2e5760fe275bce71610f4a127654121c87d20f636914f6
BLAKE2b-256 checksum
How to use checksums
7177774852c367f5a7bb89e8cc309821603f20bc1b5e3aba23221c7c5ecdcdc3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.15

Release files / tisement_agent-0.2.0-py3-none-any.whl

Download URL tisement_agent-0.2.0-py3-none-any.whl
Size 32.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
60918408c162fee6d402b945707b965c134fa75505978f254b48a75647ad5ec7
BLAKE2b-256 checksum
How to use checksums
b6d191efa48d82fa12a7982ad35d123d13dcb6c2bfa8f8376f41dd19cd3d1504
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.15

Security for tisement-agent 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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