POST /internal/communication/send

Unified message sending interface for internal microservice calls. Supports SMS, email, and push channels, and both template-based and direct content sending modes. Creates real send records in the database and attempts asynchronous sending. Uses InternalAPIKeyAuth authentication. References: ePrivacy Directive 2002/58/EC, CAN-SPAM Act.

Request Body

Schema: dto.InternalSendRequest

Field	Type	Required	Example	Constraints	Description
channel	string	Yes	email
to	string	Yes	user@example.com
content	string	No	Your verification code is 123456.
metadata	object	No		extra keys: `string`
subject	string	No	Account activation
template	string	No	welcome
user_id	string	No	usr_abc123
variables	object	No		extra keys: `string`

Responses

Status	Description	Schema
200	Message queued/sent, returns message ID and status	dto.InternalSendDetailResponse
400	Invalid request parameters	dto.SimpleResponse
500	Internal server error	dto.SimpleResponse

Referenced Schemas

dto.InternalSendDetailResponse

Field	Type	Required	Example	Constraints	Description
code	integer	No
data	dto.InternalSendResponse	No
message	string	No
timestamp	string	No

dto.InternalSendResponse

Response information for the internal unified sending interface.

Field	Type	Required	Example	Constraints	Description
channel	string	No	email
message_id	string	No	internal-1234567890
status	string	No	queued
to	string	No	user@example.com

dto.SimpleResponse

Field	Type	Required	Example	Constraints	Description
code	integer	No
message	string	No
timestamp	string	No