Metadados em TelegramOutboundMessage.metadata (string→string). priority em options usa fila dedicada Telegram + fila prioritária de webhooks quando high.
Variáveis para substituir placeholders {{chave}} em payload.message, payload.caption e options.autoReplyText.
Show child attributes
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).
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Notifique","description":"API multicanal para WhatsApp, SMS, e-mail, push e mais. Integre, teste no sandbox e use IA com llms.txt e MCP.","colors":{"primary":"#fbbf24","light":"#fbbf24","dark":"#fbbf24"},"logo":{"light":"https://mintcdn.com/tribus/bZe-7RiENjmeF_O7/logo/light.png?fit=max\u0026auto=format\u0026n=bZe-7RiENjmeF_O7\u0026q=85\u0026s=64d67c9a1c52ec357777b5632f714882","dark":"https://mintcdn.com/tribus/bZe-7RiENjmeF_O7/logo/dark.png?fit=max\u0026auto=format\u0026n=bZe-7RiENjmeF_O7\u0026q=85\u0026s=2df6ca04be3fb36c080492c1c205975f"},"favicon":"https://mintcdn.com/tribus/bZe-7RiENjmeF_O7/favicon.svg?fit=max\u0026auto=format\u0026n=bZe-7RiENjmeF_O7\u0026q=85\u0026s=3ea7b1631da416de0c1a7ee57d439c56","api":{"playground":{"display":"interactive"},"examples":{"languages":["curl","javascript","python","go"],"prefill":true,"autogenerate":true}},"navbar":{"links":[{"href":"https://status.notifique.dev","label":"Status"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.notifique.dev"}},"styling":{"latex":true},"navigation":{"languages":[{"language":"pt-BR","default":true,"navbar":{"links":[{"href":"https://status.notifique.dev","label":"Status"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.notifique.dev"}},"href":"welcome/welcome"},{"language":"en","href":"en/welcome/welcome"},{"language":"es","href":"es/welcome/welcome"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tribus","hasAudioNarration":false,"actualSubdomain":"tribus","customDomains":["docs.notifique.dev"],"gitSource":{"type":"github","owner":"notifique-dev","repo":"notifique-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ad52bcc29f358e945e24eef","collectionId":"53455186-1186-4cb7-b9b1-ff28dfb2c0ce","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad52bcc29f358e945e24eef"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ad52bcc29f358e945e24eef","clientVersion":"0.0.4045","searchFilterCounts":[{"language":"default","tag":"Guias","count":56},{"language":"default","tag":"Automações","count":53},{"language":"en","tag":"WhatsApp","count":50},{"language":"default","tag":"Contatos","count":49},{"language":"pt-BR","tag":"WhatsApp","count":46},{"language":"es","tag":"WhatsApp","count":46},{"language":"pt-BR","tag":"Guias","count":40},{"language":"en","tag":"Guides","count":40},{"language":"es","tag":"Guías","count":40},{"language":"pt-BR","tag":"Automações","count":38},{"language":"en","tag":"Add-ons","count":37},{"language":"en","tag":"Automations","count":35},{"language":"es","tag":"Add-ons","count":35},{"language":"pt-BR","tag":"Add-ons","count":34},{"language":"en","tag":"Instagram","count":33},{"language":"pt-BR","tag":"Instagram","count":32},{"language":"es","tag":"Automatizaciones","count":32},{"language":"es","tag":"Instagram","count":32},{"language":"en","tag":"Contacts","count":29},{"language":"pt-BR","tag":"Contatos","count":28},{"language":"en","tag":"Telegram","count":28},{"language":"es","tag":"Contactos","count":28},{"language":"es","tag":"Telegram","count":27},{"language":"pt-BR","tag":"Telegram","count":25},{"language":"pt-BR","tag":"Instâncias","count":25},{"language":"default","tag":"Voz","count":23},{"language":"en","tag":"Instâncias","count":22},{"language":"es","tag":"Instâncias","count":21},{"language":"default","tag":"Chat","count":21},{"language":"default","tag":"WhatsApp","count":19},{"language":"en","tag":"Mensagens","count":18},{"language":"en","tag":"Voice","count":17},{"language":"es","tag":"Mensagens","count":17},{"language":"pt-BR","tag":"Voz","count":15},{"language":"pt-BR","tag":"Mensagens","count":15},{"language":"es","tag":"Voz","count":15},{"language":"default","tag":"Assistentes","count":14},{"language":"default","tag":"Add-ons","count":14},{"language":"default","tag":"Mensagens","count":13},{"language":"default","tag":"Push","count":13}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"welcome-hero.css","content":"@keyframes welcome-line-flow{0%{stroke-dashoffset:0}to{stroke-dashoffset:-240}}@keyframes welcome-node-pulse{0%,to{opacity:.55;transform:scale(1)}50%{opacity:1;transform:scale(1.35)}}@keyframes welcome-ring-expand{0%{opacity:.5;transform:scale(.6)}70%,to{opacity:0;transform:scale(2.2)}}@keyframes welcome-glow-drift{0%,to{transform:translate(0,0) scale(1)}33%{transform:translate(24px,-16px) scale(1.05)}66%{transform:translate(-18px,12px) scale(.95)}}@keyframes welcome-grid-pulse{0%,to{opacity:.35}50%{opacity:.9}}.welcome-hero{position:relative;overflow:hidden;text-align:center;padding:96px 24px;margin-bottom:-16px;background:#09090b;-webkit-mask-image:linear-gradient(to bottom,#000 0,#000 calc(100% - 56px),rgba(0,0,0,.98) calc(100% - 49px),rgba(0,0,0,.96) calc(100% - 44px),rgba(0,0,0,.93) calc(100% - 39px),rgba(0,0,0,.89) calc(100% - 34px),rgba(0,0,0,.84) calc(100% - 29px),rgba(0,0,0,.78) calc(100% - 25px),rgba(0,0,0,.71) calc(100% - 21px),rgba(0,0,0,.63) calc(100% - 17px),rgba(0,0,0,.54) calc(100% - 13px),rgba(0,0,0,.44) calc(100% - 10px),rgba(0,0,0,.34) calc(100% - 7px),rgba(0,0,0,.24) calc(100% - 5px),rgba(0,0,0,.15) calc(100% - 3px),rgba(0,0,0,.08) calc(100% - 1px),transparent 100%);mask-image:linear-gradient(to bottom,#000 0,#000 calc(100% - 56px),rgba(0,0,0,.98) calc(100% - 49px),rgba(0,0,0,.96) calc(100% - 44px),rgba(0,0,0,.93) calc(100% - 39px),rgba(0,0,0,.89) calc(100% - 34px),rgba(0,0,0,.84) calc(100% - 29px),rgba(0,0,0,.78) calc(100% - 25px),rgba(0,0,0,.71) calc(100% - 21px),rgba(0,0,0,.63) calc(100% - 17px),rgba(0,0,0,.54) calc(100% - 13px),rgba(0,0,0,.44) calc(100% - 10px),rgba(0,0,0,.34) calc(100% - 7px),rgba(0,0,0,.24) calc(100% - 5px),rgba(0,0,0,.15) calc(100% - 3px),rgba(0,0,0,.08) calc(100% - 1px),transparent 100%);-webkit-mask-size:100% 100%;mask-size:100% 100%}.welcome-hero-bg{position:absolute;inset:0;pointer-events:none;overflow:hidden}.welcome-hero-glow{position:absolute;border-radius:50%;filter:blur(72px);opacity:.45;animation:welcome-glow-drift 18s ease-in-out infinite}.welcome-hero-glow-1{width:420px;height:420px;top:-120px;left:8%;background:rgba(251,191,36,.22);animation-delay:0s}.welcome-hero-glow-2{width:360px;height:360px;top:10%;right:5%;background:rgba(245,158,11,.14);animation-delay:-6s}.welcome-hero-glow-3{width:280px;height:280px;bottom:-40px;left:42%;background:rgba(251,191,36,.1);animation-delay:-12s}.welcome-hero-svg{position:absolute;inset:0;width:100%;height:100%;opacity:.9}.welcome-hero-grid line{stroke:rgba(251,191,36,.06);stroke-width:1}.welcome-hero-grid line:nth-child(odd){animation:welcome-grid-pulse 8s ease-in-out infinite}.welcome-hero-grid line:nth-child(even){animation:welcome-grid-pulse 8s ease-in-out infinite reverse;animation-delay:-4s}.welcome-hero-path{fill:none;stroke:url(#welcome-line-gradient);stroke-width:1.5;stroke-linecap:round;stroke-dasharray:6 14;animation:welcome-line-flow 22s linear infinite}.welcome-hero-path-2{animation-duration:28s;animation-direction:reverse;stroke-dasharray:4 18;opacity:.7}.welcome-hero-path-3{animation-duration:18s;stroke-dasharray:8 10;opacity:.55}.welcome-hero-node{fill:#fbbf24;filter:drop-shadow(0 0 8px rgba(251,191,36,.65));animation:welcome-node-pulse 4s ease-in-out infinite}.welcome-hero-node-2{animation-delay:-1.2s}.welcome-hero-node-3{animation-delay:-2.4s}.welcome-hero-node-4{animation-delay:-.6s}.welcome-hero-node-5{animation-delay:-1.8s}.welcome-hero-node-6{animation-delay:-3s}.welcome-hero-ring{fill:none;stroke:rgba(251,191,36,.2);stroke-width:1;transform-origin:center;animation:welcome-ring-expand 5s ease-out infinite}.welcome-hero-ring-2{animation-delay:-2.5s}.welcome-hero-content{position:relative;z-index:2}@media (prefers-reduced-motion:reduce){.welcome-hero-glow,.welcome-hero-grid line,.welcome-hero-node,.welcome-hero-path,.welcome-hero-ring{animation:none!important}}"}],"page":{"pagePath":"api-reference/mensagens/enviar-mensaje-en-telegram","slug":"/api-reference/mensagens/enviar-mensaje-en-telegram","pageMetadata":{"title":"Enviar mensaje en Telegram","description":"Envía un mensaje a uno o más destinatarios en Telegram. Escribe el texto al momento o usa una plantilla.","deprecated":null,"version":null,"openapi":"/es/telegram-api/api-reference/openapi-telegram.json post /v1/telegram/messages","href":"/api-reference/mensagens/enviar-mensaje-en-telegram","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Envía un mensaje a uno o más destinatarios en Telegram. Escribe el texto al momento o usa una plantilla.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Enviar mensaje en Telegram","description":"Envía un mensaje a uno o más destinatarios en Telegram. Escribe el texto al momento o usa una plantilla.","deprecated":null,"version":null,"openapi":"/es/telegram-api/api-reference/openapi-telegram.json post /v1/telegram/messages","href":"/api-reference/mensagens/enviar-mensaje-en-telegram","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Mensagens"],"summary":"Enviar mensaje en Telegram","description":"Envía un mensaje a uno o más destinatarios en Telegram. Escribe el texto al momento o usa una plantilla.","operationId":"ntfTg_postV1TelegramSend","parameters":["a076c7ba-79a2-4527-b0ce-b0dbc478cdbc","b5489e90-0f0f-4a5f-87e0-3accb7ec4991"],"requestBody":"06d6acc6-721d-4669-a6ef-d20ab9511530","responses":{"200":"773e88de-f51d-4314-bc5c-25ae1b42378d","202":"9870d1c5-7254-4325-836d-62ec04051067","400":"b5b79165-4f04-43ce-9a7c-346194c80276","401":"d136c28f-876b-4d88-a360-e2d4cba4b1dc","402":"e8694539-dd09-49ad-b94e-7d2ca9f9b6e9","403":"8deed5d2-7aa8-487a-b3a8-20da60169169","404":"421e715d-374c-42b3-bfba-7054f6c23dd0","429":"eafd3897-7b03-4f5b-b814-7930699006f3","503":"6deb34b8-fe2c-4be4-b640-34309277a472"},"method":"post","type":"path","servers":["1a55b9bb-12ce-48de-b27c-897bffa8aeec"],"security":["3f192b88-62ba-4ce0-a85a-df387b1192c3","b7b86481-de26-4233-88de-0c478be26ba8"],"path":"/v1/telegram/messages","baseUrlOptions":["https://api.notifique.dev"],"title":"Enviar mensaje en Telegram","codeSamples":[],"requestExampleLanguages":["bash","javascript","python","go"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.to.items.0":"@usuario","body.type":"text","body.payload.message":"Olá!","body.from":"inst_abc"},{"body.to.items.0":"@usuario","body.type":"image","body.payload.mediaUrl":"https://example.com/image.jpg","body.payload.fileName":"image.jpg","body.payload.mimetype":"image/jpeg","body.payload.caption":"Legenda","body.from":"inst_abc"},{"body.to.items.0":"@usuario","body.type":"video","body.payload.mediaUrl":"https://example.com/video.mp4","body.payload.fileName":"video.mp4","body.payload.mimetype":"video/mp4","body.from":"inst_abc"},{"body.to.items.0":"@usuario","body.type":"audio","body.payload.mediaUrl":"https://example.com/audio.mp3","body.payload.fileName":"audio.mp3","body.payload.mimetype":"audio/mpeg","body.from":"inst_abc"},{"body.to.items.0":"@usuario","body.type":"document","body.payload.mediaUrl":"https://example.com/file.pdf","body.payload.fileName":"file.pdf","body.payload.mimetype":"application/pdf","body.from":"inst_abc"},{"body.to.items.0":"@usuario","body.type":"location","body.payload.latitude":-23.55,"body.payload.longitude":-46.63,"body.from":"inst_abc"}]},"dependencies":{"parameters":{"a076c7ba-79a2-4527-b0ce-b0dbc478cdbc":{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}},"b5489e90-0f0f-4a5f-87e0-3accb7ec4991":{"name":"x-idempotency-key","in":"header","required":false,"schema":{"type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["from","to","type","payload"],"properties":{"to":{"type":"array","items":{"type":"string","uniqueKey":"to.items.[INDEX]","typeLabel":"string"},"minItems":1,"maxItems":500,"description":"chat_id ou @username","isRequired":true,"uniqueKey":"to","typeLabel":"string[]"},"type":{"type":"string","enum":["text","image","video","audio","document","location","template"],"isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"payload":{"type":"object","description":"Conforme `type` (message, mediaUrl, latitude/longitude, templateId/variables, etc.)","properties":{"mediaUrl":{"type":"string","format":"uri","description":"URL pública. Obrigatório para image, video, audio, document.","uniqueKey":"payload.mediaUrl","typeLabel":"string\u003curi>"},"fileName":{"type":"string","description":"Nome do arquivo. Obrigatório para mídia.","uniqueKey":"payload.fileName","typeLabel":"string"},"mimetype":{"type":"string","description":"Mimetype (ex.: image/jpeg, audio/mpeg, application/pdf). Obrigatório para mídia.","uniqueKey":"payload.mimetype","typeLabel":"string"},"caption":{"type":"string","maxLength":1024,"description":"Legenda opcional para mídia.","uniqueKey":"payload.caption","typeLabel":"string"},"latitude":{"type":"number","uniqueKey":"payload.latitude","typeLabel":"number"},"longitude":{"type":"number","uniqueKey":"payload.longitude","typeLabel":"number"},"name":{"type":"string","uniqueKey":"payload.name","typeLabel":"string"},"address":{"type":"string","uniqueKey":"payload.address","typeLabel":"string"},"templateId":{"type":"string","description":"Obrigatório para type=template.","uniqueKey":"payload.templateId","typeLabel":"string"},"variables":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"payload.variables.additionalProperties","typeLabel":"string"},"description":"Variáveis do template.","uniqueKey":"payload.variables","typeLabel":"object"},"buttons":{"type":"array","maxItems":3,"description":"Botones inline URL (texto o media). Cada ítem: label (o displayText) y url HTTPS.","items":{"type":"object","required":["label","url"],"properties":{"label":{"type":"string","maxLength":64,"isRequired":true,"uniqueKey":"payload.buttons.items.[INDEX].label","typeLabel":"string"},"displayText":{"type":"string","description":"Alias de label.","uniqueKey":"payload.buttons.items.[INDEX].displayText","typeLabel":"string"}},"uniqueKey":"payload.buttons.items.[INDEX]","typeLabel":"object"},"uniqueKey":"payload.buttons","typeLabel":"object[]"},"message":{"type":"string","example":"Olá!","uniqueKey":"payload.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"payload","typeLabel":"object"},"from":{"type":"string","description":"Instância Telegram: id ou nome.","isRequired":true,"uniqueKey":"from","typeLabel":"string"},"schedule":{"type":"object","properties":{"sendAt":{"type":"string","format":"date-time","uniqueKey":"schedule.sendAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"schedule","typeLabel":"object"},"options":{"type":"object","properties":{"priority":{"type":"string","enum":["high","normal","low"],"description":"`high` = fila Redis `queue:telegram:priority` e fila prioritária de webhooks.","uniqueKey":"options.priority","typeLabel":"enum\u003cstring>"},"maxRetries":{"type":"integer","uniqueKey":"options.maxRetries","typeLabel":"integer"},"webhook":{"type":"object","description":"Webhook só para este envio (eventos `telegram.*`). URL HTTPS pública.","required":["url"],"properties":{"secret":{"type":"string","description":"Opcional. Segredo HMAC.","uniqueKey":"options.webhook.secret","typeLabel":"string"}},"uniqueKey":"options.webhook","typeLabel":"object"},"autoReplyText":{"type":"string","maxLength":4096,"description":"Texto enviado automáticamente (1×) cuando el destinatario responda.","uniqueKey":"options.autoReplyText","typeLabel":"string"}},"uniqueKey":"options","typeLabel":"object"},"metadata":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"metadata.additionalProperties","typeLabel":"string"},"description":"Metadados em `TelegramOutboundMessage.metadata` (string→string). `priority` em `options` usa fila dedicada Telegram + fila prioritária de webhooks quando `high`.","uniqueKey":"metadata","typeLabel":"object"},"localization":{"type":"object","description":"Tradução por destinatário (manual ou IA). Campos traduzíveis: payload.message, payload.caption.","properties":{"mode":{"type":"string","enum":["off","manual","ai"],"default":"off","description":"off = sem tradução; manual = usa i18n; ai = traduz com IA conforme idioma do contato.","uniqueKey":"localization.mode","typeLabel":"enum\u003cstring>"},"sourceLocale":{"type":"string","description":"Locale BCP-47 do texto base (ex.: pt-BR).","uniqueKey":"localization.sourceLocale","typeLabel":"string"}},"uniqueKey":"localization","typeLabel":"object"},"i18n":{"type":"object","additionalProperties":true,"description":"Mapa locale → string ou objeto com chaves por campo (message, caption, …). Usado com localization.mode=manual.","uniqueKey":"i18n","typeLabel":"object"},"variables":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"variables.additionalProperties","typeLabel":"string"},"description":"Variáveis para substituir placeholders {{chave}} em payload.message, payload.caption e options.autoReplyText.","uniqueKey":"variables","typeLabel":"object"}},"example":{"to":["5511999999999"],"type":"text","payload":{"mediaUrl":"https://example.com/resource","fileName":"string","mimetype":"string","caption":"string","latitude":1,"longitude":1,"name":"Exemplo","address":"string","templateId":"clxx...","variables":{},"buttons":[{"label":"string","displayText":"string"}]},"schedule":{"sendAt":"2025-02-10T14:00:00.000Z"},"options":{"priority":"high","maxRetries":1,"webhook":{"secret":"string"},"autoReplyText":"string"},"metadata":{},"localization":{"mode":"off","sourceLocale":"string"},"i18n":{},"variables":{},"from":"clxx..."},"uniqueKey":"","typeLabel":"object"},"examples":{"text":{"title":"text","value":{"to":["@usuario"],"type":"text","payload":{"message":"Olá!"},"from":"inst_abc"}},"image":{"title":"image","value":{"to":["@usuario"],"type":"image","payload":{"mediaUrl":"https://example.com/image.jpg","caption":"Legenda","mimetype":"image/jpeg","fileName":"image.jpg"},"from":"inst_abc"}},"video":{"title":"video","value":{"to":["@usuario"],"type":"video","payload":{"mediaUrl":"https://example.com/video.mp4","mimetype":"video/mp4","fileName":"video.mp4"},"from":"inst_abc"}},"audio":{"title":"audio","value":{"to":["@usuario"],"type":"audio","payload":{"mediaUrl":"https://example.com/audio.mp3","mimetype":"audio/mpeg","fileName":"audio.mp3"},"from":"inst_abc"}},"document":{"title":"document","value":{"to":["@usuario"],"type":"document","payload":{"mediaUrl":"https://example.com/file.pdf","fileName":"file.pdf","mimetype":"application/pdf"},"from":"inst_abc"}},"location":{"title":"location","value":{"to":["@usuario"],"type":"location","payload":{"latitude":-23.55,"longitude":-46.63},"from":"inst_abc"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"773e88de-f51d-4314-bc5c-25ae1b42378d":{"description":"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).","content":{"application/json":{"schema":{"type":"object","properties":{"from":{"type":"string","description":"Instância Telegram: id ou nome.","isRequired":true,"uniqueKey":"from","typeLabel":"string"},"success":{"type":"boolean","uniqueKey":"success","typeLabel":"boolean"},"data":{"type":"object","additionalProperties":true,"example":{"messageIds":["clxx_msg_1"],"count":1,"status":"QUEUED","scheduledAt":null,"sandbox":false},"properties":{"messageIds":{"type":"array","items":{"type":"string","uniqueKey":"data.messageIds.items.[INDEX]","typeLabel":"string"},"example":["clxx_a","clxx_b"],"uniqueKey":"data.messageIds","typeLabel":"string[]"},"count":{"type":"integer","example":2,"uniqueKey":"data.count","typeLabel":"integer"},"status":{"type":"string","example":"QUEUED","uniqueKey":"data.status","typeLabel":"string"},"sandbox":{"type":"boolean","example":false,"uniqueKey":"data.sandbox","typeLabel":"boolean"},"scheduledAt":{"type":"string","example":"2026-04-15T10:00:00.000Z","uniqueKey":"data.scheduledAt","typeLabel":"string"}},"uniqueKey":"data","typeLabel":"object"}},"example":{"success":true},"required":["from"],"uniqueKey":"","typeLabel":"object"},"example":{"success":true,"data":{"messageIds":["clxx_msg_1"],"count":1,"status":"QUEUED","scheduledAt":null,"sandbox":false}},"examples":{"Example":{"title":"Example","value":{"success":true,"data":{"messageIds":["clxx_msg_1"],"count":1,"status":"QUEUED","scheduledAt":null,"sandbox":false}}}},"exampleType":"examples"}},"exampleType":"examples"},"9870d1c5-7254-4325-836d-62ec04051067":{"description":"Aceito. `data.messageIds` lista os IDs internos; `status` é `QUEUED` (envio imediato na fila) ou `SCHEDULED` (com `scheduledAt` em ISO 8601 quando houver agendamento).","content":{"application/json":{"schema":{"type":"object","properties":{"from":{"type":"string","description":"Instância Telegram: id ou nome.","isRequired":true,"uniqueKey":"from","typeLabel":"string"},"success":{"type":"boolean","uniqueKey":"success","typeLabel":"boolean"},"data":{"type":"object","additionalProperties":true,"example":{"messageIds":["clxx_msg_1"],"count":1,"status":"QUEUED","scheduledAt":null,"sandbox":false},"properties":{"messageIds":{"type":"array","items":{"type":"string","uniqueKey":"data.messageIds.items.[INDEX]","typeLabel":"string"},"example":["clxx_a","clxx_b"],"uniqueKey":"data.messageIds","typeLabel":"string[]"},"count":{"type":"integer","example":2,"uniqueKey":"data.count","typeLabel":"integer"},"status":{"type":"string","example":"QUEUED","uniqueKey":"data.status","typeLabel":"string"},"sandbox":{"type":"boolean","example":false,"uniqueKey":"data.sandbox","typeLabel":"boolean"},"scheduledAt":{"type":"string","example":"2026-04-15T10:00:00.000Z","uniqueKey":"data.scheduledAt","typeLabel":"string"}},"uniqueKey":"data","typeLabel":"object"}},"example":{"success":true},"required":["from"],"uniqueKey":"","typeLabel":"object"},"examples":{"queued":{"title":"queued","value":{"success":true,"data":{"messageIds":["clxx_a","clxx_b"],"count":2,"status":"QUEUED","sandbox":false}}},"scheduled":{"title":"scheduled","value":{"success":true,"data":{"messageIds":["clxx_c"],"count":1,"status":"SCHEDULED","scheduledAt":"2026-04-15T10:00:00.000Z","sandbox":false}}}},"exampleType":"examples"}},"exampleType":"examples"},"b5b79165-4f04-43ce-9a7c-346194c80276":{"description":"Corpo inválido, tipo não suportado, validação de conteúdo ou regra de negócio.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","description":"Rótulo HTTP do erro (ex.: Unauthorized, Bad Request, Not Found).","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Mensaje legível para exibir ao usuário (localizada via Accept-Language / x-locale quando aplicável).","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"Código estável da API v1 (enum). Sempre presente em erros. Use com o status HTTP para decidir retry ou correção. Ver [Respuestas de erro](/guides/conceitos/resposta-de-erros).","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","uniqueKey":"details.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","uniqueKey":"details.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details","typeLabel":"object[]"}},"required":["success","error","message","code"],"example":{"success":false,"error":"string","message":"string","code":"string","details":[{"field":"string","message":"string"}]},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":"Bad Request","message":"Unsupported message type for this Telegram instance mode.","code":"TELEGRAM_TYPE_UNSUPPORTED"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Bad Request","message":"Unsupported message type for this Telegram instance mode.","code":"TELEGRAM_TYPE_UNSUPPORTED"}}},"exampleType":"examples"}},"exampleType":"examples"},"d136c28f-876b-4d88-a360-e2d4cba4b1dc":{"description":"Chave ausente ou inválida.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","description":"Rótulo HTTP do erro (ex.: Unauthorized, Bad Request, Not Found).","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Mensaje legível para exibir ao usuário (localizada via Accept-Language / x-locale quando aplicável).","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"Código estável da API v1 (enum). Sempre presente em erros. Use com o status HTTP para decidir retry ou correção. Ver [Respuestas de erro](/guides/conceitos/resposta-de-erros).","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","uniqueKey":"details.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","uniqueKey":"details.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details","typeLabel":"object[]"}},"required":["success","error","message","code"],"example":{"success":false,"error":"string","message":"string","code":"string","details":[{"field":"string","message":"string"}]},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":"Unauthorized","message":"Invalid or missing API Key","code":"UNAUTHORIZED"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Unauthorized","message":"Invalid or missing API Key","code":"UNAUTHORIZED"}}},"exampleType":"examples"}},"exampleType":"examples"},"e8694539-dd09-49ad-b94e-7d2ca9f9b6e9":{"description":"Plano/créditos: workspace bloqueado, saldo insuficiente ou limite de gasto da chave.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","description":"Rótulo HTTP do erro (ex.: Unauthorized, Bad Request, Not Found).","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Mensaje legível para exibir ao usuário (localizada via Accept-Language / x-locale quando aplicável).","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"Código estável da API v1 (enum). Sempre presente em erros. Use com o status HTTP para decidir retry ou correção. Ver [Respuestas de erro](/guides/conceitos/resposta-de-erros).","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","uniqueKey":"details.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","uniqueKey":"details.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details","typeLabel":"object[]"}},"required":["success","error","message","code"],"example":{"success":false,"error":"string","message":"string","code":"string","details":[{"field":"string","message":"string"}]},"uniqueKey":"","typeLabel":"object"},"examples":{"blocked":{"title":"blocked","value":{"success":false,"error":"Payment Required","message":"Plan expired or suspended","code":"WORKSPACE_BLOCKED"}},"credits":{"title":"credits","value":{"success":false,"error":"Payment Required","message":"Insufficient credits.","code":"INSUFFICIENT_CREDITS"}},"keyLimit":{"title":"keyLimit","value":{"success":false,"error":"Payment Required","message":"API key spend limit exceeded.","code":"API_KEY_SPEND_LIMIT_EXCEEDED"}}},"exampleType":"examples"}},"exampleType":"examples"},"8deed5d2-7aa8-487a-b3a8-20da60169169":{"description":"Sem escopo **telegram:send**, limite de instancias do plano ou instancia não permitida para esta chave.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","description":"Rótulo HTTP do erro (ex.: Unauthorized, Bad Request, Not Found).","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Mensaje legível para exibir ao usuário (localizada via Accept-Language / x-locale quando aplicável).","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"Código estável da API v1 (enum). Sempre presente em erros. Use com o status HTTP para decidir retry ou correção. Ver [Respuestas de erro](/guides/conceitos/resposta-de-erros).","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","uniqueKey":"details.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","uniqueKey":"details.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details","typeLabel":"object[]"}},"required":["success","error","message","code"],"example":{"success":false,"error":"string","message":"string","code":"string","details":[{"field":"string","message":"string"}]},"uniqueKey":"","typeLabel":"object"},"examples":{"scope":{"title":"scope","value":{"success":false,"error":"Forbidden","message":"Missing scope: telegram:send","code":"FORBIDDEN"}},"instance":{"title":"instance","value":{"success":false,"error":"Forbidden","message":"Access to this instance is not allowed by this API Key","code":"FORBIDDEN"}}},"exampleType":"examples"}},"exampleType":"examples"},"421e715d-374c-42b3-bfba-7054f6c23dd0":{"description":"Instancia inexistente ou não é Telegram.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","description":"Rótulo HTTP do erro (ex.: Unauthorized, Bad Request, Not Found).","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Mensaje legível para exibir ao usuário (localizada via Accept-Language / x-locale quando aplicável).","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"Código estável da API v1 (enum). Sempre presente em erros. Use com o status HTTP para decidir retry ou correção. Ver [Respuestas de erro](/guides/conceitos/resposta-de-erros).","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","uniqueKey":"details.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","uniqueKey":"details.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details","typeLabel":"object[]"}},"required":["success","error","message","code"],"example":{"success":false,"error":"string","message":"string","code":"string","details":[{"field":"string","message":"string"}]},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":"Not Found","message":"Instance not found","code":"NOT_FOUND"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Not Found","message":"Instance not found","code":"NOT_FOUND"}}},"exampleType":"examples"}},"exampleType":"examples"},"eafd3897-7b03-4f5b-b814-7930699006f3":{"description":"Limite de mensagens pendentes no canal Telegram para este workspace. Pode vir cabeçalho `Retry-After` (segundos) no aviso leve.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","description":"Rótulo HTTP do erro (ex.: Unauthorized, Bad Request, Not Found).","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Mensaje legível para exibir ao usuário (localizada via Accept-Language / x-locale quando aplicável).","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"Código estável da API v1 (enum). Sempre presente em erros. Use com o status HTTP para decidir retry ou correção. Ver [Respuestas de erro](/guides/conceitos/resposta-de-erros).","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","uniqueKey":"details.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","uniqueKey":"details.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details","typeLabel":"object[]"}},"required":["success","error","message","code"],"example":{"success":false,"error":"string","message":"string","code":"string","details":[{"field":"string","message":"string"}]},"uniqueKey":"","typeLabel":"object"},"examples":{"soft":{"title":"soft","value":{"success":false,"error":"Too Many Requests","message":"Workspace backlog soft limit reached for Telegram.","code":"WORKSPACE_BACKLOG_SOFT_LIMIT"}},"hard":{"title":"hard","value":{"success":false,"error":"Too Many Requests","message":"Workspace backlog limit reached for Telegram.","code":"WORKSPACE_BACKLOG_LIMIT"}}},"exampleType":"examples"}},"exampleType":"examples"},"6deb34b8-fe2c-4be4-b640-34309277a472":{"description":"No foi possível colocar o job na fila (tente de novo).","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","description":"Rótulo HTTP do erro (ex.: Unauthorized, Bad Request, Not Found).","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Mensaje legível para exibir ao usuário (localizada via Accept-Language / x-locale quando aplicável).","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"Código estável da API v1 (enum). Sempre presente em erros. Use com o status HTTP para decidir retry ou correção. Ver [Respuestas de erro](/guides/conceitos/resposta-de-erros).","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","uniqueKey":"details.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","uniqueKey":"details.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details","typeLabel":"object[]"}},"required":["success","error","message","code"],"example":{"success":false,"error":"string","message":"string","code":"string","details":[{"field":"string","message":"string"}]},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":"Service Unavailable","message":"Failed to enqueue message","code":"SERVICE_UNAVAILABLE"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Service Unavailable","message":"Failed to enqueue message","code":"SERVICE_UNAVAILABLE"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"3f192b88-62ba-4ce0-a85a-df387b1192c3":{"ntfTgBearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"Authorization: Bearer sk_live_xxxxx","scopes":[]}},"b7b86481-de26-4233-88de-0c478be26ba8":{"ntfTgApiKeyHeader":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[]}}},"servers":{"1a55b9bb-12ce-48de-b27c-897bffa8aeec":{"url":"https://api.notifique.dev","description":"Producción"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"Authorization: Bearer sk_live_xxxxx","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Authorization: Bearer sk_live_xxxxx","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ntfTgBearerAuth","name":"Authorization"}],"title":"ntfTgBearerAuth"},{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[]},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ntfTgApiKeyHeader","name":"x-api-key"}],"title":"ntfTgApiKeyHeader"}]},"originalFileLocation":"es/telegram-api/api-reference/openapi-telegram.json"},"subdomain":"tribus","siteName":"Notifique","title":"Enviar mensaje en Telegram - Notifique","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"pt-BR":{"href":"/welcome/welcome","matchLevel":4},"en":{"href":"/en/welcome/welcome","matchLevel":4},"es":{"href":"/api-reference/mensagens/enviar-mensaje-en-telegram","matchLevel":0}}},"lastModified":"2026-08-31T13:53:47.074Z","originalFileLocation":"api-reference/mensagens/enviar-mensaje-en-telegram.mdx","locale":"es"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Envía un mensaje a uno o más destinatarios en Telegram. Escribe el texto al momento o usa una plantilla.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Notifique\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tribus/lrSzNckWGT07xfjB/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/tribus/lrSzNckWGT07xfjB/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tribus/lrSzNckWGT07xfjB/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/tribus/lrSzNckWGT07xfjB/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/tribus/lrSzNckWGT07xfjB/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tribus/lrSzNckWGT07xfjB/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tribus/lrSzNckWGT07xfjB/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/tribus/lrSzNckWGT07xfjB/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/tribus/lrSzNckWGT07xfjB/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Enviar mensaje en Telegram - Notifique\">\u003cmeta data-mint-head property=\"og:description\" content=\"Envía un mensaje a uno o más destinatarios en Telegram. Escribe el texto al momento o usa una plantilla.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Notifique\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.notifique.dev/api-reference/mensagens/enviar-mensaje-en-telegram\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tribus.mintlify.app/_mintlify/api/og/v2?division=Mensagens\u0026amp;title=Enviar+mensaje+en+Telegram\u0026amp;description=Env%C3%ADa+un+mensaje+a+uno+o+m%C3%A1s+destinatarios+en+Telegram.+Escribe+el+texto+al+momento+o+usa+una+plantilla.\u0026amp;theme=8c9a8f58518c7b0a360dbb49\u0026amp;signature=8dde760cf2a9bb832a5c8a425f3461b45e46689d9708436e3eea5fd4689ca061\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Enviar mensaje en Telegram - Notifique\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Envía un mensaje a uno o más destinatarios en Telegram. Escribe el texto al momento o usa una plantilla.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tribus.mintlify.app/_mintlify/api/og/v2?division=Mensagens\u0026amp;title=Enviar+mensaje+en+Telegram\u0026amp;description=Env%C3%ADa+un+mensaje+a+uno+o+m%C3%A1s+destinatarios+en+Telegram.+Escribe+el+texto+al+momento+o+usa+una+plantilla.\u0026amp;theme=8c9a8f58518c7b0a360dbb49\u0026amp;signature=8dde760cf2a9bb832a5c8a425f3461b45e46689d9708436e3eea5fd4689ca061\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/tribus/lrSzNckWGT07xfjB/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Notifique\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#fbbf24\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.notifique.dev/api-reference/mensagens/enviar-mensaje-en-telegram\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/mensagens/enviar-mensaje-en-telegram.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.notifique.dev/#organization\",\"name\":\"Notifique\",\"url\":\"https://docs.notifique.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tribus/bZe-7RiENjmeF_O7/logo/light.png?fit=max\u0026auto=format\u0026n=bZe-7RiENjmeF_O7\u0026q=85\u0026s=64d67c9a1c52ec357777b5632f714882\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.notifique.dev#website\",\"name\":\"Notifique\",\"url\":\"https://docs.notifique.dev\",\"publisher\":{\"@id\":\"https://docs.notifique.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.notifique.dev/api-reference/mensagens/enviar-mensaje-en-telegram#webpage\",\"url\":\"https://docs.notifique.dev/api-reference/mensagens/enviar-mensaje-en-telegram\",\"name\":\"Enviar mensaje en Telegram\",\"description\":\"Envía un mensaje a uno o más destinatarios en Telegram. Escribe el texto al momento o usa una plantilla.\",\"dateModified\":\"2026-08-31T13:53:47.074Z\",\"isPartOf\":{\"@id\":\"https://docs.notifique.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.notifique.dev/api-reference/mensagens/enviar-mensaje-en-telegram#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.notifique.dev/api-reference/mensagens/enviar-mensaje-en-telegram#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Mensagens\",\"item\":\"https://docs.notifique.dev/api-reference/mensagens/listar-mensajes-telegram\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Enviar mensaje en Telegram\",\"item\":\"https://docs.notifique.dev/api-reference/mensagens/enviar-mensaje-en-telegram\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.notifique.dev/api-reference/mensagens/enviar-mensaje-en-telegram#apireference\",\"headline\":\"Enviar mensaje en Telegram\",\"name\":\"Enviar mensaje en Telegram\",\"description\":\"Envía un mensaje a uno o más destinatarios en Telegram. Escribe el texto al momento o usa una plantilla.\",\"url\":\"https://docs.notifique.dev/api-reference/mensagens/enviar-mensaje-en-telegram\",\"mainEntityOfPage\":{\"@id\":\"https://docs.notifique.dev/api-reference/mensagens/enviar-mensaje-en-telegram#webpage\"},\"dateModified\":\"2026-08-31T13:53:47.074Z\",\"publisher\":{\"@id\":\"https://docs.notifique.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.notifique.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Notifique\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Notifique","nav":{"global":null,"languages":[{"language":"pt-BR","default":true,"navbar":{"links":[{"href":"https://status.notifique.dev","label":"Status"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.notifique.dev"}},"pages":[{"title":"pt-BR","href":"/welcome/welcome"}]},{"language":"en","pages":[{"title":"en","href":"/en/welcome/welcome"}]},{"language":"es","tabs":[{"tab":"Bienvenido","pages":[{"title":"Bienvenido","href":"/es/welcome/welcome"}]},{"tab":"Guías","pages":[{"title":"Guías","href":"/es/guides/introducao/comece-aqui"}]},{"tab":"WhatsApp","pages":[{"title":"WhatsApp","href":"/es/whatsapp-api/como-funciona/introducao"}]},{"tab":"SMS","pages":[{"title":"SMS","href":"/es/sms-api/como-funciona/introducao"}]},{"tab":"Telegram","groups":[{"group":"API Telegram","pages":[{"title":"Introducción","icon":"paper-plane","href":"/es/telegram-api/como-funciona/introducao"},{"title":"Inicio rápido","icon":"bolt","href":"/es/telegram-api/como-funciona/quick-start"},{"title":"Modos de conexión","icon":"split","href":"/es/telegram-api/como-funciona/modos-de-conexao"},{"title":"Alcances clave API","icon":"key","href":"/es/telegram-api/como-funciona/escopos-api-key"},{"title":"Eventos de Webhook","icon":"code-merge","href":"/es/telegram-api/como-funciona/eventos-do-webhooks"}]},{"group":"Instancias","pages":[{"title":"Activar bot con token","deprecated":null,"version":null,"openapi":"/es/telegram-api/api-reference/openapi-telegram.json post /v1/telegram/instances/{instanceId}/bot-token","href":"/api-reference/instancias/activar-bot-con-token"}]},{"group":"Mensagens","pages":[{"title":"Listar mensajes Telegram","description":"Muestra el historial de Telegram enviados. Puedes filtrar por fecha y estado.","deprecated":null,"version":null,"openapi":"/es/telegram-api/api-reference/openapi-telegram.json get /v1/telegram/messages","href":"/api-reference/mensagens/listar-mensajes-telegram"},{"title":"Enviar mensaje en Telegram","deprecated":null,"version":null,"openapi":"/es/telegram-api/api-reference/openapi-telegram.json post /v1/telegram/messages","href":"/api-reference/mensagens/enviar-mensaje-en-telegram"},{"title":"Listar chats Telegram","description":"Lista conversaciones que interactuaron con tu bot o cuenta.","deprecated":null,"version":null,"openapi":"/es/telegram-api/api-reference/openapi-telegram.json get /v1/telegram/chats","href":"/api-reference/mensagens/listar-chats-telegram"},{"title":"Listar recibidos Telegram","deprecated":null,"version":null,"openapi":"/es/telegram-api/api-reference/openapi-telegram.json get /v1/telegram/messages/inbound","href":"/api-reference/mensagens/listar-recibidos-telegram"},{"title":"Consultar recibido Telegram","deprecated":null,"version":null,"openapi":"/es/telegram-api/api-reference/openapi-telegram.json get /v1/telegram/messages/inbound/{id}","href":"/api-reference/mensagens/consultar-recibido-telegram"},{"title":"Descargar media recibida (base64)","deprecated":null,"version":null,"openapi":"/es/telegram-api/api-reference/openapi-telegram.json post /v1/telegram/messages/inbound/{id}/media","href":"/api-reference/mensagens/descargar-media-recibida-base64"},{"title":"Descargar media recibida (archivo)","deprecated":null,"version":null,"openapi":"/es/telegram-api/api-reference/openapi-telegram.json get /v1/telegram/messages/inbound/{id}/media/download","href":"/api-reference/mensagens/descargar-media-recibida-archivo"},{"title":"Consultar envío Telegram","deprecated":null,"version":null,"openapi":"/es/telegram-api/api-reference/openapi-telegram.json get /v1/telegram/messages/{messageId}","href":"/api-reference/mensagens/consultar-envío-telegram"},{"title":"Eliminar mensaje Telegram","deprecated":null,"version":null,"openapi":"/es/telegram-api/api-reference/openapi-telegram.json delete /v1/telegram/messages/{messageId}","href":"/api-reference/mensagens/eliminar-mensaje-telegram"},{"title":"Cancelar Telegram programado","deprecated":null,"version":null,"openapi":"/es/telegram-api/api-reference/openapi-telegram.json post /v1/telegram/messages/{messageId}/cancel","href":"/api-reference/mensagens/cancelar-telegram-programado"},{"title":"Editar mensaje Telegram","deprecated":null,"version":null,"openapi":"/es/telegram-api/api-reference/openapi-telegram.json patch /v1/telegram/messages/{messageId}/edit","href":"/api-reference/mensagens/editar-mensaje-telegram"}]},{"group":"Instâncias","pages":[{"title":"Listar conexiones Telegram","deprecated":null,"version":null,"openapi":"/es/telegram-api/api-reference/openapi-telegram.json get /v1/telegram/instances","href":"/api-reference/instâncias/listar-conexiones-telegram"},{"title":"Crear instância Telegram","deprecated":null,"version":null,"openapi":"/es/telegram-api/api-reference/openapi-telegram.json post /v1/telegram/instances","href":"/api-reference/instâncias/crear-instância-telegram"},{"title":"Consultar conexión Telegram","deprecated":null,"version":null,"openapi":"/es/telegram-api/api-reference/openapi-telegram.json get /v1/telegram/instances/{instanceId}","href":"/api-reference/instâncias/consultar-conexión-telegram"},{"title":"Eliminar conexión Telegram","deprecated":null,"version":null,"openapi":"/es/telegram-api/api-reference/openapi-telegram.json delete /v1/telegram/instances/{instanceId}","href":"/api-reference/instâncias/eliminar-conexión-telegram"},{"title":"Estado del enlace Telegram","deprecated":null,"version":null,"openapi":"/es/telegram-api/api-reference/openapi-telegram.json get /v1/telegram/instances/{instanceId}/connect-page","href":"/api-reference/instâncias/estado-del-enlace-telegram"},{"title":"Activar enlace Telegram","deprecated":null,"version":null,"openapi":"/es/telegram-api/api-reference/openapi-telegram.json post /v1/telegram/instances/{instanceId}/connect-page/enable","href":"/api-reference/instâncias/activar-enlace-telegram"},{"title":"Renovar secreto del enlace Telegram","deprecated":null,"version":null,"openapi":"/es/telegram-api/api-reference/openapi-telegram.json post /v1/telegram/instances/{instanceId}/connect-page/rotate-secret","href":"/api-reference/instâncias/renovar-secreto-del-enlace-telegram"},{"title":"Desactivar enlace Telegram","deprecated":null,"version":null,"openapi":"/es/telegram-api/api-reference/openapi-telegram.json post /v1/telegram/instances/{instanceId}/connect-page/disable","href":"/api-reference/instâncias/desactivar-enlace-telegram"},{"title":"Obtener QR Telegram","deprecated":null,"version":null,"openapi":"/es/telegram-api/api-reference/openapi-telegram.json get /v1/telegram/instances/{instanceId}/qr","href":"/api-reference/instâncias/obtener-qr-telegram"},{"title":"Cancelar Telegram programado","deprecated":null,"version":null,"openapi":"/es/telegram-api/api-reference/openapi-telegram.json post /v1/telegram/instances/{instanceId}/qr/cancel","href":"/api-reference/instâncias/cancelar-telegram-programado"},{"title":"Guardar sesión Telegram","deprecated":null,"version":null,"openapi":"/es/telegram-api/api-reference/openapi-telegram.json post /v1/telegram/instances/{instanceId}/session","href":"/api-reference/instâncias/guardar-sesión-telegram"}]}]},{"tab":"Instagram","pages":[{"title":"Instagram","href":"/es/instagram-api/como-funciona/introducao"}]},{"tab":"Correo","pages":[{"title":"Correo","href":"/es/emails-api/como-funciona/introducao"}]},{"tab":"Push","pages":[{"title":"Push","href":"/es/push-api/como-funciona/introducao"}]},{"tab":"Chat","pages":[{"title":"Chat","href":"/es/chat-api/como-funciona/introducao"}]},{"tab":"RCS","pages":[{"title":"RCS","href":"/es/rcs-api/como-funciona/introducao"}]},{"tab":"Voz","pages":[{"title":"Voz","href":"/es/voice-api/como-funciona/introducao"}]},{"tab":"Chat web","pages":[{"title":"Chat web","href":"/es/ai-web-widget"}]},{"tab":"Plantillas","pages":[{"title":"Plantillas","href":"/es/template-api/como-funciona/introducao"}]},{"tab":"Contactos","pages":[{"title":"Contactos","href":"/es/contacts-api/como-funciona/introducao"}]},{"tab":"Automatizaciones","pages":[{"title":"Automatizaciones","href":"/es/automations-api/como-funciona/introducao"}]},{"tab":"Add-ons","pages":[{"title":"Add-ons","href":"/es/addons"}]}]}]},"basePath":"","title":"Enviar mensaje en Telegram - Notifique","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DCDCdBVX.js","utils-ME8dDnLe.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-0e84ACsd.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-wgRBj-ia.js","snippetPresets-C11Sgb-o.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-C0lapOpP.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-ZeRQV8fF.js","shallow-BupWh095.js","getApiPlaygroundDisplay-BnYQO2Ss.js","CodeSnippet-RKKOc8c_.js","CodeSnippets-Drf_m8wS.js","Page-Bevw23-4.js","getPastedJson-u6QiPzNZ.js","icon-Bb-CBSxO.js","MethodPill-F7l5AI7V.js","DuplicateIcon-IiAXkdSg.js","createIcon-FliI8EBc.js","DynamicMarkdown-B62XqCSI.js","SectionHeading-Dj31pT03.js","axios-vUo_bRtp.js","Markdown-BOgQCTwD.js","clsx-BIWXJmsZ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DKZWslLH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-UDqbR6xh.js"]}