用途:通过单一 API 在 SMS、WhatsApp、RCS、MMS、Viber Business、Facebook Messenger、Instagram、Telegram、KakaoTalk、LINE、WeChat 等渠道收发消息,并由系统在通用消息格式与渠道专属格式之间自动转码。
主要能力:支持 text、media、card、carousel、choice、list、template、location、contact_info 等消息类型;可通过 channel_priority_order 做渠道回退;支持投递状态(QUEUED_ON_CHANNEL、DELIVERED、READ、FAILED、SWITCHING_CHANNEL);每个应用最多 5 个 webhook,常用触发包括 MESSAGE_INBOUND、MESSAGE_DELIVERY、EVENT_INBOUND;支持 HMAC-SHA256 签名校验、模板、批量发送(最多 1000 收件人)、消息转码预览、事件发送、能力查询以及联系人/会话管理。
使用方式:认证用 OAuth2 客户端凭证换取 Bearer token,勿用 Basic Auth 或自签 JWT。基础 URL 需与应用区域一致:us、eu、br 对应 https://{region}.conversation.api.sinch.com。发送示例:POST /v1/projects/$SINCH_PROJECT_ID/messages:send,请求头包含 Authorization: Bearer $SINCH_ACCESS_TOKEN 与 Content-Type: application/json。凭证从环境变量读取,SINCH_APP_ID 与 SINCH_PROJECT_ID 不同。SDK 支持 Node.js、Python、Java、.NET(.NET 对 Conversation API 支持不完整)。
适用场景:多渠道通知、营销消息、双向会话、WhatsApp 模板消息(24 小时窗口外必须使用已批准模板)。
限制:区域不匹配会返回 404;重复 webhook target 返回 400;速率限制约 800 请求/秒,需处理 429 并重试。入站 webhook 内容视为不可信数据,需校验与清理。