Messages

POST /v1/messages/send
Required scope:
message.send

Request

{
  "target_ref": "@iambatashev",
  "text": "Message text"
}

Fields

NameTypeRequiredDescription
target_refstringyesTelegram username, link, or target reference
textstringyesMessage text

Response

{
  "id": "2c78360b-4cdd-45d2-b565-5511da7c7a44",
  "token_id": "421b2b13-dc93-4f46-b9f8-bf7d61a31e51",
  "account_id": "1fb30cd8-d4bd-41d8-80c8-fb18aa9e3d88",
  "target_ref": "@iambatashev",
  "text": "Message text",
  "status": "sent",
  "telegram_message_id": "12345",
  "error_text": null
}

Status values

StatusMeaning
pendingMessage record was created before Telegram delivery
sentTelegram accepted the message
failedDelivery failed and error_text contains the provider error