Skip to main content
POST

Autorizações

Authorization
string
header
obrigatório

Authorization: Bearer sk_live_xxxxx

Cabeçalhos

Idempotency-Key
string
x-idempotency-key
string

Corpo

application/json
instanceId
string
obrigatório
to
string[]
obrigatório

chat_id ou @username

Required array length: 1 - 100 elements
type
enum<string>
obrigatório
Opções disponíveis:
text,
image,
video,
audio,
document,
location,
template
payload
object
obrigatório

Conforme type (message, mediaUrl, latitude/longitude, templateId/variables, etc.)

schedule
object
options
object
metadata
object

Metadados em TelegramOutboundMessage.metadata (string→string). priority em options usa fila dedicada Telegram + fila prioritária de webhooks quando high.

Resposta

Mesmo corpo de sucesso de um envio anterior: você reutilizou Idempotency-Key ou x-idempotency-key e o servidor devolve o resultado já registrado (não duplica envio).

success
boolean
data
object