Code examples

The examples show the common tasks in PHP, Node.js, Python and C#, without any package beyond the language's standard library. Each language has a small client that the other examples use; copy it into your project and adapt the error handling to your own code.

Configuration

The examples read the base URL and the key from the environment, never from the source code:

export UPPU_API_BASE=https://messaging-staging.uppu.net/v1   # production: https://messaging.uppu.net/v1
export UPPU_API_KEY=uppu_test_...                           # production: uppu_live_...
export UPPU_WEBHOOK_SECRET=whsec_...                         # the signing secret of your webhook endpoint

• The ids in the examples (01j9z0ch5k2m4n6p8q0r2s4t6v and the like) are placeholders: take the channel id from GET /v1/channels, and contact and message ids from your webhook events.
• The client retries network errors, 5xx answers and errors marked retryable with the same Idempotency-Key, so a retry never sends a message twice.
• A webhook receiver checks the signature over the raw body before anything else and answers 2xx at once.

Examples