WhatsApp Bot

Simple WhatsApp bot infrastructure on AWS Lambda using CDK.

Setup

uv sync

To start developing locally:

docker compose up

Create the tables:

• EVENTS_TABLE
• MESSAGES_TABLE

make tables

Create the RAG bucket:

make bucket

Run the app:

uv run uvicorn handler:app --reload

Docker

If you don't want to read:

docker compose up --build

Deployment

Deploy:

npx aws-cdk deploy --app 'uv run infra.py' --verbose
# or
make deploy

Destroy:

npx aws-cdk destroy --app 'uv run infra.py' --verbose
# or
make destroy

Redeploy:

npx aws-cdk destroy --app 'uv run infra.py' --verbose
# or
make reset

Infrastructure

Architecture Diagram

Architecture diagram of the infrastructure:

graph TD
    User --[send message]--> WhatsApp
    WhatsApp --[wbehooks]--> ApiGateway
    ApiGateway --> Lambda
    Lambda --[store chat messages]--> MessageTable
    Lambda --[store raw events]--> EventTable
    Lambda --[send message]--> WhatsApp

Loading

Sequence diagram of the message flow:

sequenceDiagram
    User->>WhatsApp: send message
    WhatsApp->>ApiGateway: POST /
    ApiGateway->>Lambda: proxy
    Lambda->>EventTable: store raw event
    Lambda->>OpenAI: generate response
    OpenAI->>Lambda: response
    Lambda->>MessageTable: store chat message
    Lambda->>WhatsApp: send message
    WhatsApp->>User: message sent

Loading