yasmine-apilisted

# Yasmine API — usage guide for AI agents Yasmine is a voice AI API that triggers outbound calls to confirm orders for resellers in Morocco, Algeria, Tunisia and France. ## Authentication All endpoints require `Authorization: Bearer yk_<40chars>` (your reseller API key). The plugin reads the key from the `YASMINE_API_TOKEN` environment variable (set once at install time, before invoking `/plugin install yasmine@akidly`). Never paste the key in chat or commit it to a repo. ## Country and language codes | Country | ISO | Default call language | |---------|-----|------------------------| | Morocco | MA | ar (darija) | | Algeria | DZ | ar (darija) | | Tunisia | TN | ar (darija) | | France | FR | fr | The `country` field on `create_call` selects the localized model variant. Use the ISO code, never the language directly. The optional `language` field overrides the default (e.g. `country=MA` + `language=fr` is supported). The combination `country=FR` + `language=ar` is rejected with `language_not_supported_for_country` (422). ## Phone number format **Strict E.164 only**. Examples : `+212612345678` (MA mobile), `+33612345678` (FR mobile). Validation rejects anything else with `validation_error` (422). ## Shops — declare once, reference later `POST /v1/shops` registers a shop with **your** identifier. Minimum: `external_id`, `name`, `country` (`MA` | `DZ` | `TN` — no `FR`, we do not sell French shops). Declaring a s