POST `/communication/callback/{provider}`

Receive and process delivery status callbacks from various SMS, email, and push providers (Alibaba Cloud, Tencent Cloud, AWS SNS/SES, SendGrid, Mailgun, FCM, APNs, JPush, etc.), automatically updating the corresponding message send status. The callback is a public endpoint called directly by each provider. References: ePrivacy Directive 2002/58/EC, CAN-SPAM Act.

Communication Service None application/json

Request Parameters

Name	In	Type	Required	Default	Example	Constraints	Description
`provider`	`path`	`string`	Yes				Provider name: aliyun/tencentcloud/aws/sendgrid/ses/mailgun/fcm/apns/jpush

Request Body

Accepts an empty JSON object {}

Responses

Status	Description	Schema
200	Callback received and acknowledged	`dto.CallbackResultDetailResponse`
400	Invalid request data format	`dto.SimpleResponse`
500	Internal callback processing error	`dto.SimpleResponse`

Referenced Schemas

dto.CallbackResultDetailResponse

Field	Type	Required
`code`	`integer`	No
`data`	`dto.CallbackResultResponse`	No
`message`	`string`	No
`timestamp`	`string`	No

dto.CallbackResultResponse

Provider callback result

Field	Type	Required	Example	Constraints	Description
`provider`	`string`	No	`aliyun`
`received`	`boolean`	No	`True`

dto.SimpleResponse

Field	Type	Required
`code`	`integer`	No
`message`	`string`	No
`timestamp`	`string`	No

Try this API in Scalar → Download OpenAPI spec (JSON) ↓

POST /communication/callback/{provider}