# Washeej Developer Documentation

> WhatsApp messaging platform API docs for humans and coding agents.

## Preferred entry points

- Canonical HTML docs: https://staging-mobile.washeej.com/api-v1-documentation/getting-started
- Machine-readable Markdown: https://staging-mobile.washeej.com/api-v1-documentation.md
- Machine-readable plain text: https://staging-mobile.washeej.com/api-v1-documentation.txt
- OpenAPI (templates lifecycle): https://staging-mobile.washeej.com/api-v1-documentation/openapi/templates.yaml
- Template lifecycle HTML: https://staging-mobile.washeej.com/api-v1-documentation/reference/templates/lifecycle
- Authentication: https://staging-mobile.washeej.com/api-v1-documentation/authentication
- Scopes: https://staging-mobile.washeej.com/api-v1-documentation/scopes
- Errors: https://staging-mobile.washeej.com/api-v1-documentation/errors
- Changelog: https://staging-mobile.washeej.com/api-v1-documentation/changelog
- Legacy Cloud API (Markdown): https://staging-mobile.washeej.com/external-api-documentation.md
- Legacy Device API (Markdown): https://staging-mobile.washeej.com/device-api-documentation.md
- This index: https://staging-mobile.washeej.com/llms.txt

## Authentication (API v1)

- Base URL: https://staging-mobile.washeej.com/v1
- Header auth: `client-id` + `client-secret` (from Developer Portal)
- Or OAuth 2.0 Bearer token (see OAuth pages)
- Rate limit: 120 requests / minute / account

## Template lifecycle (availability)

- Code deployed; public docs available.
- Global lifecycle activation remains disabled unless canary/feature assignment allows.
- Internal Meta canary qualification pending — do not assume Meta E2E passed.
- Lifecycle send requires `Idempotency-Key` on `/v1/templates/send` and `/external-api/templates/send`.

## HTML pages (API v1)

- Getting Started: https://staging-mobile.washeej.com/api-v1-documentation/getting-started
- Authentication: https://staging-mobile.washeej.com/api-v1-documentation/authentication
- Response Format: https://staging-mobile.washeej.com/api-v1-documentation/response-format
- Errors: https://staging-mobile.washeej.com/api-v1-documentation/errors
- Account: https://staging-mobile.washeej.com/api-v1-documentation/reference/account
- Contacts: https://staging-mobile.washeej.com/api-v1-documentation/reference/contacts
- Conversations: https://staging-mobile.washeej.com/api-v1-documentation/reference/conversations
- Messages: https://staging-mobile.washeej.com/api-v1-documentation/reference/messages
- Templates (send): https://staging-mobile.washeej.com/api-v1-documentation/reference/templates
- WhatsApp Templates API: https://staging-mobile.washeej.com/api-v1-documentation/reference/templates/lifecycle
- Templates lifecycle send: https://staging-mobile.washeej.com/api-v1-documentation/reference/templates/lifecycle/send
- Templates lifecycle idempotency: https://staging-mobile.washeej.com/api-v1-documentation/reference/templates/lifecycle/idempotency
- CRM Scenario Routing: https://staging-mobile.washeej.com/api-v1-documentation/guides/crm-scenario-routing
- Devices: https://staging-mobile.washeej.com/api-v1-documentation/reference/devices
- Webhooks Overview: https://staging-mobile.washeej.com/api-v1-documentation/reference/webhooks
- Webhooks Manage: https://staging-mobile.washeej.com/api-v1-documentation/reference/webhooks/manage
- Webhook Payloads: https://staging-mobile.washeej.com/api-v1-documentation/reference/webhooks/payloads
- OAuth: https://staging-mobile.washeej.com/api-v1-documentation/oauth
- Scopes: https://staging-mobile.washeej.com/api-v1-documentation/scopes
- Integration Playbook: https://staging-mobile.washeej.com/api-v1-documentation/guides/integration-playbook
- Channel Selection: https://staging-mobile.washeej.com/api-v1-documentation/guides/channel-selection
- Session Window vs Templates: https://staging-mobile.washeej.com/api-v1-documentation/guides/session-window
- Session Media: https://staging-mobile.washeej.com/api-v1-documentation/guides/session-media
- Interactive Messages: https://staging-mobile.washeej.com/api-v1-documentation/guides/interactive-messages
- Template Media Headers: https://staging-mobile.washeej.com/api-v1-documentation/guides/template-media-headers
- Dynamic Invoice Link: https://staging-mobile.washeej.com/api-v1-documentation/guides/dynamic-invoice-link
- Authentication OTP: https://staging-mobile.washeej.com/api-v1-documentation/guides/authentication-otp
- Changelog: https://staging-mobile.washeej.com/api-v1-documentation/changelog

## Notes for agents

- Prefer the `.md` / `.txt` / OpenAPI URLs above for complete, lossless reading.
- Use only public HTTPS documentation URLs — never invent repository filesystem paths as HTTP endpoints.
- The HTML UI is optimized for humans; machine-readable mirrors stay in sync with the same PHP config source of truth.
- Do not invent endpoints — only use paths documented in the Markdown dump and OpenAPI contract.