Skip to main content
POST

Autorizaciones

Authorization
string
header
requerido

Authorization: Bearer sk_live_xxxxx

Encabezados

Idempotency-Key
string
x-idempotency-key
string

Cuerpo

application/json
instanceId
string
requerido
to
string[]
requerido

chat_id ou @username

Required array length: 1 - 100 elements
type
enum<string>
requerido
Opciones disponibles:
text,
image,
video,
audio,
document,
location,
template
payload
object
requerido

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.

Respuesta

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