> For the complete documentation index, see [llms.txt](https://doc.mantago.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.mantago.cc/wen-jian-shuo-ming-1/yong-hu-tui-bo.md).

# 用戶推播

## Send broadcast message

> Send broadcast messages to customers

```json
{"openapi":"3.0.3","info":{"title":"Manta OpenAPI","version":"0.363.10"},"tags":[{"name":"Core","description":"Core OpenAPI functionality for customer management and broadcasting"}],"servers":[{"url":"https://mantago.cc/api","description":"MantaGo Openapi host url"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer token for API authentication"}},"schemas":{"BroadcastRequest":{"type":"object","properties":{"secret":{"type":"string","description":"Secret key for API authentication"},"intentId":{"type":"string","description":"Intent identifier for the broadcast (required if message is empty)"},"message":{"type":"string","description":"Message content to broadcast (required if intentId is empty)"},"clientIds":{"type":"array","items":{"type":"string"},"description":"Array of platform UUIDs to send the broadcast to"},"platform":{"type":"string","enum":["line","facebook","instagram","whatsapp"],"description":"Platform to send the broadcast on (required)"},"fbTag":{"type":"string","description":"Facebook tag for the broadcast (required when platform is 'facebook')"},"name":{"type":"string","description":"Name of this broadcast"}},"required":["secret","platform","name"],"description":"Additional validation rules:\n- Either intentId or message must be provided (cannot both be empty)\n- fbTag is required when platform is 'facebook'\n"},"BasicSuccessResponse":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]},"ErrorResponse":{"type":"object","properties":{"success":{"type":"boolean"},"errResponse":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer"},"botId":{"type":"string"}},"required":["message","code"]}},"required":["success","errResponse"]}},"responses":{"TokenError":{"description":"JWT token is invalid or expired","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"RateLimitError":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"InternalServerError":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/openapi/broadcast":{"post":{"tags":["Core"],"summary":"Send broadcast message","description":"Send broadcast messages to customers","parameters":[{"name":"botId","in":"query","required":true,"schema":{"type":"string"},"description":"The bot ID for the API request"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BroadcastRequest"}}}},"responses":{"200":{"description":"Broadcast sent successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BasicSuccessResponse"}}}},"401":{"$ref":"#/components/responses/TokenError"},"403":{"description":"Permission or broadcast creation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/RateLimitError"},"500":{"$ref":"#/components/responses/InternalServerError"}}}}}}
```