{
"code": "max_scheduled_messages_reached",
"message": "You have reached the maximum of 10 scheduled messages. Cancel pending messages or upgrade your plan."
}
{
"code": "max_scheduled_messages_reached",
"message": "You have reached the maximum of 10 scheduled messages. Cancel pending messages or upgrade your plan."
}
Respondendo Mensagens
Para responder a mensagens já enviadas ou recebidas, utilize a propriedade reply_to. Isso permite que sua resposta seja vinculada diretamente à mensagem original, proporcionando um contexto claro na conversa (como mostrado na imagem abaixo).O formato do ID muda conforme o tipo de conexão da instância:
Não oficial (QR code): o ID devolvido no envio ou recebido no webhook, como 3EB04E7F387C999A0DD61D.
Oficial (WABA): o wamid de uma mensagem da mesma conversa, como wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjNFQjA....
Limitação (não oficial): Atualmente, só é possível responder a mensagens que foram enviadas/recebidas nos últimos 7 dias.
Oficial (WABA): um ID que não seja um wamid válido da conversa é recusado pela Meta, e a requisição volta com erro 400 trazendo a mensagem original dela.
Agendando mensagens
Para agendar uma mensagem para envio futuro, adicione o campo send_at ao body da requisição com a data e hora no formato ISO 8601.Quando send_at está presente, a resposta muda:
Status HTTP 201 (em vez de 200)
Corpo com message_id, status: "scheduled" e send_at em UTC
O campo send_at é opcional. Quando não informado, a mensagem é enviada imediatamente como sempre.
O send_at deve ser no mínimo 1 minuto no futuro. O limite máximo depende do seu plano.
Veja os limites por plano.
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Cabeçalhos
X-Instance-ID
string
Obrigatório se instance_id não estiver presente no body.
Corpo
application/json
recipient
string
obrigatório
Número ou ID do grupo para onde será enviada a mensagem. Em caso de grupo o ID deve ser prefixado com o texto group: (Ex. group:123456789987654321). Em instâncias oficiais (WABA), este campo também aceita um BSUID (Business-Scoped User ID) para usuários com telefone oculto, ex. US.13491208655302741918. Veja o guia Enviar mensagens para BSUID.
Exemplo:
"group:123456789987654321"
text
string
obrigatório
Texto a ser enviado para o recipient (destinatário), no caso de envio de mídias esta propriedade não é obrigatória.
instance_id
string
ID da instância, obrigatório se X-Instance-ID não for informado nos cabeçalhos.
Exemplo:
"ozj35qv418rpmlrb"
auto_delete
boolean
padrão:false
Opção válida apenas quando o recipient não é um grupo. Se true então o chat/conversa será excluído após o envio da mensagem.
auto_mention
boolean
padrão:true
Opção válida apenas quando o recipient é um grupo. Se true então todo "@" seguido de um número será tratado como uma menção, então se no text ou media.caption tiver algo como "Olá @5599123451234" então tentaremos encontrar o número no grupo e fazer a menção/marcação automática.
O formato do número após o @ deve ser internacional, DDI + DDD + Número.
view_once
boolean
padrão:false
Opção válida apenas para mensagens de áudio, imagens e vídeos. Se true então só será possível visualizar a mensagem uma única vez.
reply_to
string
Para responder a uma mensagem específica, informe o ID da mensagem que deseja responder. Ao utilizar essa funcionalidade corretamente, sua resposta será vinculada à mensagem original, marcando-a de forma clara na conversa.
O formato do ID muda conforme o tipo de conexão da instância: na API não oficial é o ID devolvido no envio ou recebido no webhook (ex.: 3EB04E7F387C999A0DD61D); na API oficial (WABA) é o wamid de uma mensagem da mesma conversa (ex.: wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjNFQjA...).
Exemplo:
"3EB04E7F387C999A0DD61D"
link_preview
boolean
padrão:true
Quando false desabilitará a pre-visualização de links que estão presentes na mensagem.
Exemplo:
false
mentions
enum<string>string[]
Há duas formas de mencionar pessoas em um grupo, você pode informar o valor everyone e todos presentes no grupo (recipient) serão mencionados, ou você pode especifica-los manualmente informando uma lista de número que deverão ser mencionados.
Opções disponíveis:
everyone
buttons
object[]
Lista de botões interativos (máximo 3). Para mais detalhes sobre tipos e modos, veja o guia de mensagens com botões.
Maximum array length: 3
Show child attributes
buttons_mode
enum<string>
padrão:auto
Modo de exibição dos botões:
auto (padrão): o sistema escolhe automaticamente com base nos tipos de botão
interactive: força o modo interativo com destaque visual
No modo auto, se pelo menos um botão for do tipo call, url ou copyable, o modo interativo é usado automaticamente.
Opções disponíveis:
auto,
interactive
template
object
Template de mensagem (apenas para instâncias WABA). Quando informado, os campos text e media são ignorados.
Show child attributes
send_at
string<date-time>
Data e hora para envio agendado no formato ISO 8601 com timezone.
Quando informado, a mensagem é agendada em vez de enviada imediatamente.
Deve ser no mínimo 1 minuto no futuro. O limite máximo depende do seu plano.
Exemplo:
"2026-03-30T09:00:00-03:00"
media
object
Show child attributes
Resposta
Success
message_id
string
obrigatório
ID usado para depuração interna
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Zapster API","colors":{"primary":"#0D9373","light":"#07C983","dark":"#0D9373"},"logo":{"light":"https://mintcdn.com/zapsterapi/hkJBRd8211Vh6izL/logo/light.svg?fit=max\u0026auto=format\u0026n=hkJBRd8211Vh6izL\u0026q=85\u0026s=7f89e972a4a31e307a18ba827099ba54","dark":"https://mintcdn.com/zapsterapi/hkJBRd8211Vh6izL/logo/dark.svg?fit=max\u0026auto=format\u0026n=hkJBRd8211Vh6izL\u0026q=85\u0026s=0584b46f3a6a9f5ef5186367a623ed31","href":"https://app.zapsterapi.com/?utm_source=Documentation\u0026utm_medium=Logo"},"favicon":"https://mintcdn.com/zapsterapi/hkJBRd8211Vh6izL/favicon.svg?fit=max\u0026auto=format\u0026n=hkJBRd8211Vh6izL\u0026q=85\u0026s=1d151a6daf40e21848a8e653dd56911e","api":{"openapi":{"source":"pt-BR/v1/openapi/openapi.json"},"playground":{"display":"interactive"}},"navbar":{"links":[{"href":"https://wa.me/5587999079455?text=Olá, preciso de ajuda com a documentação da Zapster","label":"Suporte"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.zapsterapi.com/?utm_source=Documentation\u0026utm_medium=NavbarButton"}},"integrations":{"gtm":{"tagId":"GTM-PF4DXJPP"}},"styling":{"latex":false},"navigation":{"languages":[{"language":"pt-BR","default":true,"href":"pt-BR/v1/introduction"},{"language":"en","href":"en/v1/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"zapsterapi","hasAudioNarration":false,"actualSubdomain":"zapsterapi","customDomains":["developer.zapsterapi.com"],"gitSource":{"type":"github","owner":"zapsterapi","repo":"zapsterapi-monorepo","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6afc7d8f837a82b451e81ec5","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"pt-BR","tag":"Referência da API","count":41},{"language":"pt-BR","tag":"Visão Geral","count":28},{"language":"pt-BR","tag":"CLI","count":18},{"language":"pt-BR","tag":"Instâncias","count":17},{"language":"en","tag":"Overview","count":16},{"language":"pt-BR","tag":"Para Grupos","count":9},{"language":"en","tag":"Guides","count":8},{"language":"pt-BR","tag":"Guias","count":8},{"language":"en","tag":"Concepts","count":7},{"language":"pt-BR","tag":"Webhooks","count":7},{"language":"pt-BR","tag":"Conceitos","count":7},{"language":"en","tag":"CLI","count":6},{"language":"pt-BR","tag":"Utilidades","count":6},{"language":"pt-BR","tag":"Mensagens","count":5},{"language":"en","tag":"Introduction","count":1}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"rbac-expansion","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":"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":"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":"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":"editor-metadata","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},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"pt-BR/v1/api-reference/messages/sending","slug":"/pt-BR/v1/api-reference/messages/sending","pageMetadata":{"title":"Enviando Mensagens","openapi":"POST /wa/messages","description":"","href":"/pt-BR/v1/api-reference/messages/sending"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Note,OptimizedImage,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`respondendo-mensagens`,children:`Respondendo Mensagens`}),`\n`,_jsxs(_components.p,{children:[`Para responder a mensagens já enviadas ou recebidas, utilize a propriedade `,_jsx(_components.code,{children:`reply_to`}),`. Isso permite que sua resposta seja vinculada diretamente à mensagem original, proporcionando um contexto claro na conversa (como mostrado na imagem abaixo).`]}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/zapsterapi/hkJBRd8211Vh6izL/pt-BR/v1/api-reference/messages/reply_to.png?fit=max\u0026auto=format\u0026n=hkJBRd8211Vh6izL\u0026q=85\u0026s=a1fbdc33cc8f32601b31d9279a524b37`,alt:`reply_to parameter`,\"data-og-width\":`679`,width:`679`,\"data-og-height\":`162`,height:`162`,\"data-path\":`pt-BR/v1/api-reference/messages/reply_to.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/zapsterapi/hkJBRd8211Vh6izL/pt-BR/v1/api-reference/messages/reply_to.png?w=280\u0026fit=max\u0026auto=format\u0026n=hkJBRd8211Vh6izL\u0026q=85\u0026s=46068e6dd72a668fe8a9c50981c37a9c 280w, https://mintcdn.com/zapsterapi/hkJBRd8211Vh6izL/pt-BR/v1/api-reference/messages/reply_to.png?w=560\u0026fit=max\u0026auto=format\u0026n=hkJBRd8211Vh6izL\u0026q=85\u0026s=f441453aeeec16123e281f030031d3b4 560w, https://mintcdn.com/zapsterapi/hkJBRd8211Vh6izL/pt-BR/v1/api-reference/messages/reply_to.png?w=840\u0026fit=max\u0026auto=format\u0026n=hkJBRd8211Vh6izL\u0026q=85\u0026s=e1ee4dd06b8144827be2160a734f67fc 840w, https://mintcdn.com/zapsterapi/hkJBRd8211Vh6izL/pt-BR/v1/api-reference/messages/reply_to.png?w=1100\u0026fit=max\u0026auto=format\u0026n=hkJBRd8211Vh6izL\u0026q=85\u0026s=f625614862e001a3c46f71baf714775b 1100w, https://mintcdn.com/zapsterapi/hkJBRd8211Vh6izL/pt-BR/v1/api-reference/messages/reply_to.png?w=1650\u0026fit=max\u0026auto=format\u0026n=hkJBRd8211Vh6izL\u0026q=85\u0026s=1c3c8b6550e00835aff4c46cc7ecd622 1650w, https://mintcdn.com/zapsterapi/hkJBRd8211Vh6izL/pt-BR/v1/api-reference/messages/reply_to.png?w=2500\u0026fit=max\u0026auto=format\u0026n=hkJBRd8211Vh6izL\u0026q=85\u0026s=b5d8b2169d8d3990fdfa683a55152e23 2500w`}),`\n`,_jsx(_components.p,{children:`O formato do ID muda conforme o tipo de conexão da instância:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Não oficial (QR code):`}),` o ID devolvido no envio ou recebido no webhook, como `,_jsx(_components.code,{children:`3EB04E7F387C999A0DD61D`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Oficial (WABA):`}),` o `,_jsx(_components.code,{children:`wamid`}),` de uma mensagem `,_jsx(_components.strong,{children:`da mesma conversa`}),`, como `,_jsx(_components.code,{children:`wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjNFQjA...`}),`.`]}),`\n`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Limitação (não oficial):`}),` Atualmente, só é possível responder a mensagens que foram enviadas/recebidas nos últimos 7 dias.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Oficial (WABA):`}),` um ID que não seja um `,_jsx(_components.code,{children:`wamid`}),` válido da conversa é recusado pela Meta, e a requisição volta com erro `,_jsx(_components.code,{children:`400`}),` trazendo a mensagem original dela.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`agendando-mensagens`,children:`Agendando mensagens`}),`\n`,_jsxs(_components.p,{children:[`Para agendar uma mensagem para envio futuro, adicione o campo `,_jsx(_components.code,{children:`send_at`}),` ao body da requisição com a data e hora no formato ISO 8601.`]}),`\n`,_jsxs(_components.p,{children:[`Quando `,_jsx(_components.code,{children:`send_at`}),` está presente, a resposta muda:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Status HTTP `,_jsx(_components.strong,{children:`201`}),` (em vez de 200)`]}),`\n`,_jsxs(_components.li,{children:[`Corpo com `,_jsx(_components.code,{children:`message_id`}),`, `,_jsx(_components.code,{children:`status: \"scheduled\"`}),` e `,_jsx(_components.code,{children:`send_at`}),` em UTC`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`O campo `,_jsx(_components.code,{children:`send_at`}),` é opcional. Quando não informado, a mensagem é enviada imediatamente como sempre.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`O `,_jsx(_components.code,{children:`send_at`}),` deve ser no mínimo 1 minuto no futuro. O limite máximo depende do seu plano.\nVeja os `,_jsx(_components.a,{href:`/pt-BR/v1/concepts/scheduled-messages#limites-por-plano`,children:`limites por plano`}),`.`]})}),`\n`,_jsxs(_components.p,{children:[`Para cancelar uma mensagem agendada, veja `,_jsx(_components.a,{href:`/pt-BR/v1/api-reference/messages/cancel-message`,children:`Cancelar mensagem`}),`.\nPara listar e rastrear todas as mensagens, veja `,_jsx(_components.a,{href:`/pt-BR/v1/api-reference/messages/list-messages`,children:`Listar mensagens`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Enviando Mensagens","openapi":"POST /wa/messages","description":"","href":"/pt-BR/v1/api-reference/messages/sending"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Respondendo Mensagens","slug":"respondendo-mensagens","depth":2,"children":[]},{"title":"Agendando mensagens","slug":"agendando-mensagens","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/zapsterapi/d763f142efc774ff/watch-openapi.js"],"openApiReferenceData":{"operation":{"summary":"Enviando Mensagens","deprecated":false,"description":"","tags":[],"security":["e1b772c1-4423-449b-a3ca-4caf1ed2a715"],"parameters":["684f83c0-d2f1-4cc7-ad06-aba369a1ad83"],"requestBody":"ff2a75d7-28ae-4ad5-bf30-0d2ad246db18","responses":{"200":"08d46fe9-0f79-4c67-a89d-3eab219040e4","201":"ef40871f-2b62-41cd-ac7e-72b9e1f167bc","422":"babf0d57-67c9-48a6-8f85-c44efc47ae1c"},"method":"post","type":"path","servers":["40c8c48a-b7aa-4336-ad34-29b4f469670a"],"path":"/wa/messages","baseUrlOptions":["https://api.zapsterapi.com/v1"],"title":"Enviando Mensagens","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"684f83c0-d2f1-4cc7-ad06-aba369a1ad83":{"name":"X-Instance-ID","in":"header","description":"Obrigatório se `instance_id` não estiver presente no `body`.","required":false,"example":"ozj35qv418rpmlrb","schema":{"type":"string","isRequired":false,"description":"Obrigatório se `instance_id` não estiver presente no `body`.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"recipient":{"type":"string","examples":["group:123456789987654321"],"description":"Número ou ID do grupo para onde será enviada a mensagem. Em caso de grupo o ID deve ser prefixado com o texto `group:` (Ex. `group:123456789987654321`). Em instâncias oficiais (WABA), este campo também aceita um BSUID (Business-Scoped User ID) para usuários com telefone oculto, ex. `US.13491208655302741918`. Veja o guia [Enviar mensagens para BSUID](/pt-BR/v1/guides/send-to-bsuid).","isRequired":true,"uniqueKey":"recipient","typeLabel":"string"},"text":{"type":"string","description":"Texto a ser enviado para o `recipient` (destinatário), no caso de envio de mídias esta propriedade não é obrigatória.","isRequired":true,"uniqueKey":"text","typeLabel":"string"},"instance_id":{"type":"string","example":"ozj35qv418rpmlrb","description":"ID da instância, obrigatório se `X-Instance-ID` não for informado nos cabeçalhos.","uniqueKey":"instance_id","typeLabel":"string"},"auto_delete":{"type":"boolean","default":false,"description":"Opção válida apenas quando o `recipient` não é um grupo. Se `true` então o chat/conversa será excluído após o envio da mensagem.","uniqueKey":"auto_delete","typeLabel":"boolean"},"auto_mention":{"type":"boolean","default":true,"description":"Opção válida apenas quando o `recipient` é um grupo. Se `true` então todo \"@\" seguido de um número será tratado como uma menção, então se no `text` ou `media.caption` tiver algo como \"Olá @5599123451234\" então tentaremos encontrar o número no grupo e fazer a menção/marcação automática.\n\nO formato do número após o **@** deve ser internacional, **DDI + DDD + Número**.\n","uniqueKey":"auto_mention","typeLabel":"boolean"},"view_once":{"type":"boolean","default":false,"description":"Opção válida apenas para mensagens de **áudio**, **imagens** e **vídeos**. Se `true` então só será possível visualizar a mensagem uma única vez.\n","uniqueKey":"view_once","typeLabel":"boolean"},"reply_to":{"type":"string","example":"3EB04E7F387C999A0DD61D","description":"Para responder a uma mensagem específica, informe o ID da mensagem que deseja responder. Ao utilizar essa funcionalidade corretamente, sua resposta será vinculada à mensagem original, marcando-a de forma clara na conversa.\n\nO formato do ID muda conforme o tipo de conexão da instância: na API não oficial é o ID devolvido no envio ou recebido no webhook (ex.: `3EB04E7F387C999A0DD61D`); na API oficial (WABA) é o `wamid` de uma mensagem da mesma conversa (ex.: `wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjNFQjA...`).\n","uniqueKey":"reply_to","typeLabel":"string"},"link_preview":{"type":"boolean","example":false,"default":true,"description":"Quando `false` desabilitará a pre-visualização de links que estão presentes na mensagem.\n","uniqueKey":"link_preview","typeLabel":"boolean"},"mentions":{"oneOf":[{"type":"string","description":"Há duas formas de mencionar pessoas em um grupo, você pode informar o valor `everyone` e todos presentes no grupo (`recipient`) serão mencionados, ou você pode especifica-los manualmente informando uma lista de número que deverão ser mencionados.\n","enum":["everyone"],"uniqueKey":"mentions.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"array","items":{"type":"string","uniqueKey":"mentions.oneOf.1.items.[INDEX]","typeLabel":"string"},"description":"Há duas formas de mencionar pessoas em um grupo, você pode informar o valor `everyone` e todos presentes no grupo (`recipient`) serão mencionados, ou você pode especifica-los manualmente informando uma lista de número que deverão ser mencionados.\n","example":[5599123451234,5599123451234],"uniqueKey":"mentions.oneOf.1","typeLabel":"string[]"}],"uniqueKey":"mentions","typeLabel":"enum\u003cstring> | string[]"},"buttons":{"type":"array","maxItems":3,"description":"Lista de botões interativos (máximo 3). Para mais detalhes sobre tipos e modos, veja o [guia de mensagens com botões](/pt-BR/v1/guides/messages-with-buttons).\n","items":{"type":"object","required":["label"],"properties":{"label":{"type":"string","maxLength":20,"description":"Texto exibido no botão (máximo 20 caracteres)","example":"Sim, quero!","isRequired":true,"uniqueKey":"buttons.items.[INDEX].label","typeLabel":"string"},"type":{"type":"string","enum":["reply","call","url","copyable"],"description":"Tipo de ação do botão:\n- `reply`: resposta rápida com texto pré-definido\n- `call`: inicia ligação para o número informado\n- `url`: abre um link no navegador\n- `copyable`: permite copiar um texto\n","example":"reply","uniqueKey":"buttons.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"id":{"type":"string","maxLength":256,"description":"ID único do botão (opcional, máximo 256 caracteres)","uniqueKey":"buttons.items.[INDEX].id","typeLabel":"string"},"phone_number":{"type":"string","description":"Número de telefone no formato internacional. Obrigatório quando `type` é `call`.","example":"+5511999999999","uniqueKey":"buttons.items.[INDEX].phone_number","typeLabel":"string"},"url":{"type":"string","format":"uri","description":"URL válida. Obrigatório quando `type` é `url`.","example":"https://exemplo.com/produto","uniqueKey":"buttons.items.[INDEX].url","typeLabel":"string\u003curi>"},"copy_code":{"type":"string","description":"Texto que será copiado. Obrigatório quando `type` é `copyable`.","example":"PROMO2024","uniqueKey":"buttons.items.[INDEX].copy_code","typeLabel":"string"}},"uniqueKey":"buttons.items.[INDEX]","typeLabel":"object"},"uniqueKey":"buttons","typeLabel":"object[]"},"buttons_mode":{"type":"string","enum":["auto","interactive"],"default":"auto","description":"Modo de exibição dos botões:\n- `auto` (padrão): o sistema escolhe automaticamente com base nos tipos de botão\n- `interactive`: força o modo interativo com destaque visual\n\nNo modo `auto`, se pelo menos um botão for do tipo `call`, `url` ou `copyable`, o modo interativo é usado automaticamente.\n","uniqueKey":"buttons_mode","typeLabel":"enum\u003cstring>"},"template":{"type":"object","description":"Template de mensagem (apenas para instâncias WABA). Quando informado, os campos `text` e `media` são ignorados.\n","properties":{"name":{"type":"string","description":"Nome do template cadastrado na Meta","example":"payment_reminder","isRequired":true,"uniqueKey":"template.name","typeLabel":"string"},"language":{"type":"string","description":"Código do idioma do template","example":"pt_BR","isRequired":true,"uniqueKey":"template.language","typeLabel":"string"},"components":{"type":"array","description":"Componentes do template com variáveis preenchidas","items":{"type":"object","properties":{"type":{"type":"string","description":"Tipo do componente (header, body, button)","example":"body","uniqueKey":"template.components.items.[INDEX].type","typeLabel":"string"},"sub_type":{"type":"string","description":"Subtipo do componente, usado apenas quando `type` é `button`:\n- `quick_reply`: botão de resposta rápida, cujo `payload` é devolvido no webhook\n- `url`: botão de URL dinâmica, cujo texto é anexado à URL base do template\n","example":"quick_reply","uniqueKey":"template.components.items.[INDEX].sub_type","typeLabel":"string"},"index":{"oneOf":[{"type":"integer","description":"Posição do botão no template aprovado, começando em `0`. Usado apenas quando `type` é `button` e deve seguir a ordem em que o botão aparece no template.\n\nAceitamos tanto o número quanto a string: `0` e `\"0\"` são equivalentes (a documentação da Meta usa a forma em string).\n","example":0,"uniqueKey":"template.components.items.[INDEX].index.oneOf.0","typeLabel":"integer"},{"type":"string","description":"Posição do botão no template aprovado, começando em `0`. Usado apenas quando `type` é `button` e deve seguir a ordem em que o botão aparece no template.\n\nAceitamos tanto o número quanto a string: `0` e `\"0\"` são equivalentes (a documentação da Meta usa a forma em string).\n","example":"0","uniqueKey":"template.components.items.[INDEX].index.oneOf.1","typeLabel":"string"}],"uniqueKey":"template.components.items.[INDEX].index","typeLabel":"integer | string"},"parameters":{"type":"array","description":"Parâmetros/variáveis do componente","items":{"type":"object","uniqueKey":"template.components.items.[INDEX].parameters.items.[INDEX]","typeLabel":"object"},"uniqueKey":"template.components.items.[INDEX].parameters","typeLabel":"object[]"}},"uniqueKey":"template.components.items.[INDEX]","typeLabel":"object"},"uniqueKey":"template.components","typeLabel":"object[]"}},"required":["name","language"],"uniqueKey":"template","typeLabel":"object"},"send_at":{"type":"string","format":"date-time","description":"Data e hora para envio agendado no formato ISO 8601 com timezone.\nQuando informado, a mensagem é agendada em vez de enviada imediatamente.\nDeve ser no mínimo 1 minuto no futuro. O limite máximo depende do seu plano.\n","example":"2026-03-30T09:00:00-03:00","uniqueKey":"send_at","typeLabel":"string\u003cdate-time>"},"media":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"URL do arquivo ou mídia que será enviado.","examples":["https://images.unsplash.com/photo-1721332155567-55d1b12aa271?q=80\u0026w=920\u0026format=jpeg\u0026fit=crop"],"uniqueKey":"media.url","typeLabel":"string\u003curi>"},"base64":{"type":"string","description":"Arquivo ou mídia codidificado no formato `base64`","examples":["iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=="],"uniqueKey":"media.base64","typeLabel":"string"},"caption":{"type":"string","description":"Legenda que irá aparecer junto da imagem, vídeo ou documento quando enviado, `text` será usado caso a legenda não seja fornecida.","uniqueKey":"media.caption","typeLabel":"string"},"playback":{"type":"boolean","default":false,"description":"Válida apenas para vídeos, e quando `true` faz um loop de repetição estilo GIF.","uniqueKey":"media.playback","typeLabel":"boolean"},"ptt":{"type":"boolean","default":true,"description":"Válida apenas para áudios. Quando `true` o áudio é entregue como mensagem de voz (gravação nativa), com a foto do perfil e o ícone de microfone; quando `false`, como áudio comum, com o ícone de fone.\n\nO padrão é `true` nos dois tipos de conexão: um áudio enviado sem o campo é entregue como mensagem de voz.\n\n**Em instâncias oficiais, a mensagem de voz exige áudio Ogg/Opus.** O WhatsApp reproduz mensagens de voz por um decodificador dedicado a esse formato: um áudio em MP3 ou AAC marcado como mensagem de voz chega com a aparência correta, mas **não reproduz no Android nem no iOS** (apenas no WhatsApp Web). Por isso, quando o áudio não é Ogg/Opus, ele é entregue como áudio comum mesmo com `ptt: true` — preferimos uma mensagem que toca a uma que apenas parece certa.\n\nPara garantir a mensagem de voz em instâncias oficiais, envie o áudio já em Ogg/Opus. A forma de onda (as barrinhas de amplitude) também depende disso: ela é derivada do áudio Opus e não aparece em outros formatos.\n","uniqueKey":"media.ptt","typeLabel":"boolean"},"ptv":{"type":"boolean","default":false,"description":"Válido apenas para vídeos, e quanto `true` o video será enviado como um [video note](https://faq.whatsapp.com/1291153701793079/?helpref=hc_fnav\u0026cms_platform=web).\n\n\n","uniqueKey":"media.ptv","typeLabel":"boolean"},"sticker":{"type":"string","default":false,"description":"Válida apenas para imagens, quando `true` a mídia será enviada como um Sticker (figurinha).","uniqueKey":"media.sticker","typeLabel":"string"},"fileName":{"type":"string","description":"Geralmente usado para arquivos (PDF, XLSX, Arquivos de texto) onde o nome do arquivo irá aparecer junto da mensagem no Whatsapp.\n\nO uso da extensão é recomendada (Ex. `arquivo.xml`), mas não obrigatória, quando a extensão é fornecida é usada como fallback caso não seja possível a identificação do arquivo através do `media.base64` ou `media.url`.\n","uniqueKey":"media.fileName","typeLabel":"string"}},"uniqueKey":"media","typeLabel":"object"}},"required":["recipient","text"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"recipient":"group:123456789987654321","text":"\u003cstring>","instance_id":"ozj35qv418rpmlrb","auto_delete":false,"auto_mention":true,"view_once":false,"reply_to":"3EB04E7F387C999A0DD61D","link_preview":false,"mentions":"everyone","buttons":[{"label":"Sim, quero!","type":"reply","id":"\u003cstring>","phone_number":"+5511999999999","url":"https://exemplo.com/produto","copy_code":"PROMO2024"}],"buttons_mode":"auto","send_at":"2026-03-30T09:00:00-03:00","media":{"url":"https://images.unsplash.com/photo-1721332155567-55d1b12aa271?q=80\u0026w=920\u0026format=jpeg\u0026fit=crop","base64":"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==","caption":"\u003cstring>","playback":false,"ptt":true,"ptv":false,"sticker":false,"fileName":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"08d46fe9-0f79-4c67-a89d-3eab219040e4":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"message_id":{"type":"string","description":"ID usado para depuração interna","isRequired":true,"uniqueKey":"message_id","typeLabel":"string"}},"required":["message_id"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"ef40871f-2b62-41cd-ac7e-72b9e1f167bc":{"description":"Mensagem agendada com sucesso","content":{"application/json":{"schema":{"type":"object","properties":{"message_id":{"type":"string","description":"Identificador único da mensagem agendada","example":"msg_k7m2nxp9q4","uniqueKey":"message_id","typeLabel":"string"},"status":{"type":"string","enum":["scheduled"],"description":"Status da mensagem","example":"scheduled","uniqueKey":"status","typeLabel":"enum\u003cstring>"},"send_at":{"type":"string","format":"date-time","description":"Data e hora de envio em UTC","example":"2026-03-30T12:00:00.000Z","uniqueKey":"send_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message_id":"msg_k7m2nxp9q4","status":"scheduled","send_at":"2026-03-30T12:00:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"babf0d57-67c9-48a6-8f85-c44efc47ae1c":{"description":"Erro de validação do agendamento","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Código do erro","enum":["max_scheduled_messages_reached","schedule_too_far_ahead"],"example":"max_scheduled_messages_reached","uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Descrição do erro","example":"You have reached the maximum of 10 scheduled messages. Cancel pending messages or upgrade your plan.","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"max_scheduled_messages_reached","message":"You have reached the maximum of 10 scheduled messages. Cancel pending messages or upgrade your plan."}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"e1b772c1-4423-449b-a3ca-4caf1ed2a715":{"bearer":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearer"}}},"servers":{"40c8c48a-b7aa-4336-ad34-29b4f469670a":{"url":"https://api.zapsterapi.com/v1","description":"Produção"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearer","name":"Authorization"}],"title":"bearer"}]},"originalFileLocation":"pt-BR/v1/openapi/openapi.json"},"subdomain":"zapsterapi","siteName":"Zapster API","title":"Enviando Mensagens - Zapster API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"pt-BR":{"href":"/pt-BR/v1/api-reference/messages/sending","matchLevel":0},"en":{"href":"/en/v1/introduction","matchLevel":4}}},"lastModified":"2026-10-03T02:49:57.602Z","originalFileLocation":"pt-BR/v1/api-reference/messages/sending.mdx","locale":"pt-BR"},"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=\"application-name\" content=\"Zapster API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/zapsterapi/cT0sfMuuEnMLr0h-/_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/zapsterapi/cT0sfMuuEnMLr0h-/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/zapsterapi/cT0sfMuuEnMLr0h-/_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/zapsterapi/cT0sfMuuEnMLr0h-/_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/zapsterapi/cT0sfMuuEnMLr0h-/_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/zapsterapi/cT0sfMuuEnMLr0h-/_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/zapsterapi/cT0sfMuuEnMLr0h-/_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/zapsterapi/cT0sfMuuEnMLr0h-/_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/zapsterapi/cT0sfMuuEnMLr0h-/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Enviando Mensagens - Zapster API\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Zapster API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developer.zapsterapi.com/pt-BR/v1/api-reference/messages/sending\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://zapsterapi.mintlify.site/_mintlify/api/og/v2?division=Mensagens\u0026amp;title=Enviando+Mensagens\u0026amp;theme=837801cf050cc6e3f1e55fba\u0026amp;signature=11af28b7d7cebde35b5727118aa30cfd075550401ca98c32a6479a530a3f749f\">\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=\"Enviando Mensagens - Zapster API\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://zapsterapi.mintlify.site/_mintlify/api/og/v2?division=Mensagens\u0026amp;title=Enviando+Mensagens\u0026amp;theme=837801cf050cc6e3f1e55fba\u0026amp;signature=11af28b7d7cebde35b5727118aa30cfd075550401ca98c32a6479a530a3f749f\">\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/zapsterapi/cT0sfMuuEnMLr0h-/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Zapster API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0D9373\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developer.zapsterapi.com/pt-BR/v1/api-reference/messages/sending\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/pt-BR/v1/api-reference/messages/sending.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developer.zapsterapi.com/#organization\",\"name\":\"Zapster API\",\"url\":\"https://developer.zapsterapi.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/zapsterapi/hkJBRd8211Vh6izL/logo/light.svg?fit=max\u0026auto=format\u0026n=hkJBRd8211Vh6izL\u0026q=85\u0026s=7f89e972a4a31e307a18ba827099ba54\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developer.zapsterapi.com#website\",\"name\":\"Zapster API\",\"url\":\"https://developer.zapsterapi.com\",\"publisher\":{\"@id\":\"https://developer.zapsterapi.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developer.zapsterapi.com/pt-BR/v1/api-reference/messages/sending#webpage\",\"url\":\"https://developer.zapsterapi.com/pt-BR/v1/api-reference/messages/sending\",\"name\":\"Enviando Mensagens\",\"dateModified\":\"2026-10-03T02:49:57.602Z\",\"isPartOf\":{\"@id\":\"https://developer.zapsterapi.com#website\"},\"breadcrumb\":{\"@id\":\"https://developer.zapsterapi.com/pt-BR/v1/api-reference/messages/sending#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.zapsterapi.com/pt-BR/v1/api-reference/messages/sending#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Zapster API\",\"item\":\"https://developer.zapsterapi.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Enviando Mensagens\",\"item\":\"https://developer.zapsterapi.com/pt-BR/v1/api-reference/messages/sending\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developer.zapsterapi.com/pt-BR/v1/api-reference/messages/sending#apireference\",\"headline\":\"Enviando Mensagens\",\"name\":\"Enviando Mensagens\",\"url\":\"https://developer.zapsterapi.com/pt-BR/v1/api-reference/messages/sending\",\"mainEntityOfPage\":{\"@id\":\"https://developer.zapsterapi.com/pt-BR/v1/api-reference/messages/sending#webpage\"},\"dateModified\":\"2026-10-03T02:49:57.602Z\",\"publisher\":{\"@id\":\"https://developer.zapsterapi.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developer.zapsterapi.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Zapster API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Zapster API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/pt-BR/v1/api-reference/messages/sending.md","siteName":"Zapster API","nav":{"global":null,"languages":[{"language":"pt-BR","default":true,"tabs":[{"tab":"Visão Geral","icon":"book-open","pages":[{"title":"Visão Geral","href":"/pt-BR/v1/introduction"}]},{"tab":"Referência da API","icon":"square-terminal","pages":[{"group":"Instâncias","pages":[{"title":"Listando Instâncias","openapi":"GET /wa/instances","href":"/pt-BR/v1/api-reference/instance/list-instances"},{"title":"Criando Instância","openapi":"POST /wa/instances","href":"/pt-BR/v1/api-reference/instance/create-instance"},{"title":"Dados da Instância","openapi":"GET /wa/instances/{instance_id}","href":"/pt-BR/v1/api-reference/instance/instance-details"},{"title":"Excluindo Instância","openapi":"DELETE /wa/instances/{instance_id}","href":"/pt-BR/v1/api-reference/instance/delete-instance"},{"title":"Obtendo QR Code","openapi":"GET /wa/instances/{instance_id}/qrcode","href":"/pt-BR/v1/api-reference/instance/instance-qrcode"},{"title":"Obtendo Cód. Pareamento","openapi":"POST /wa/instances/{instance_id}/pairing-code","href":"/pt-BR/v1/api-reference/instance/pairing-code"},{"title":"Reconectando uma Instância WABA","openapi":"POST /wa/instances/{instance_id}/reconnect","href":"/pt-BR/v1/api-reference/instance/reconnect-instance"},{"title":"Migrando o Tipo de Conexão","openapi":"POST /wa/instances/{instance_id}/migrate","href":"/pt-BR/v1/api-reference/instance/migrate-instance"},{"title":"Criando Webhooks","openapi":"POST /wa/instances/{instance_id}/webhooks","href":"/pt-BR/v1/api-reference/instance/create-webhook"},{"title":"Atualizando Webhooks","openapi":"PATCH /wa/instances/{instance_id}/webhooks/{webhook_id}","href":"/pt-BR/v1/api-reference/instance/update-webhook"},{"title":"Excluindo Webhooks","openapi":"DELETE /wa/instances/{instance_id}/webhooks/{webhook_id}","href":"/pt-BR/v1/api-reference/instance/delete-webhook"},{"title":"Ligando Instância","openapi":"POST /wa/instances/{instance_id}/power-on","href":"/pt-BR/v1/api-reference/instance/power-instance-on"},{"title":"Desligando Instância","openapi":"POST /wa/instances/{instance_id}/power-off","href":"/pt-BR/v1/api-reference/instance/power-instance-off"},{"title":"Reiniciando Instância","openapi":"POST /wa/instances/{instance_id}/restart","href":"/pt-BR/v1/api-reference/instance/restart-instance"},{"title":"Atualizando a Instância","openapi":"PATCH /wa/instances/{instance_id}","href":"/pt-BR/v1/api-reference/instance/update-instance"},{"title":"Atualizando Perfil","openapi":"PATCH /wa/instances/{instance_id}/profile","href":"/pt-BR/v1/api-reference/instance/update-profile"},{"title":"Atualizando Configurações","openapi":"PATCH /wa/instances/{instance_id}/settings","href":"/pt-BR/v1/api-reference/instance/update-settings"}]},{"group":"Confirmações","pages":[{"title":"Pré-autorizando uma Confirmação","openapi":"POST /confirmations","href":"/pt-BR/v1/api-reference/confirmations/issue-confirmation"}]},{"group":"Webhooks","pages":[{"title":"Listar Webhooks","openapi":"GET /webhooks","href":"/pt-BR/v1/api-reference/webhooks/list-webhooks"},{"title":"Atualizar Webhook","openapi":"PATCH /webhooks/{webhook_id}","href":"/pt-BR/v1/api-reference/webhooks/update-webhook"},{"title":"Excluir Webhook","openapi":"DELETE /webhooks/{webhook_id}","description":null,"href":"/pt-BR/v1/api-reference/webhooks/delete-webhook"}]},{"group":"Mensagens","pages":[{"title":"Enviando Mensagens","openapi":"POST /wa/messages","href":"/pt-BR/v1/api-reference/messages/sending"},{"title":"Cancelar Mensagem Agendada","openapi":"DELETE /wa/messages/{id}","description":"Cancela uma mensagem que ainda não foi enviada.\nSó funciona para mensagens com status `scheduled` ou `pending`.\nMensagens já enviadas, falhadas ou canceladas retornam erro 422.\n","href":"/pt-BR/v1/api-reference/messages/cancel-message"},{"title":"Marcar Mensagem como Lida","openapi":"POST /wa/messages/{id}/read","href":"/pt-BR/v1/api-reference/messages/read-message"},{"title":"Marcar Mensagens como Lidas (Lote)","openapi":"POST /wa/messages/read","href":"/pt-BR/v1/api-reference/messages/read-messages-batch"},{"title":"Listar Mensagens","openapi":"GET /wa/messages","href":"/pt-BR/v1/api-reference/messages/list-messages"}]},{"group":"Para Grupos","pages":[{"title":"Listar Grupos","openapi":"GET /wa/instances/{instance_id}/groups","href":"/pt-BR/v1/api-reference/groups/fetch-all"},{"title":"Criar um Grupo","openapi":"POST /wa/instances/{instance_id}/groups","href":"/pt-BR/v1/api-reference/groups/create"},{"title":"Atualizar um Grupo","openapi":"PATCH /wa/instances/{instance_id}/groups/{group_id}","href":"/pt-BR/v1/api-reference/groups/update-data"},{"title":"Listar Participantes","openapi":"GET /wa/instances/{instance_id}/groups/{group_id}/participants","href":"/pt-BR/v1/api-reference/groups/fetch-participants"},{"title":"Adicionar Participantes","openapi":"POST /wa/instances/{instance_id}/groups/{group_id}/participants","href":"/pt-BR/v1/api-reference/groups/add-participants"},{"title":"Remover Participantes","openapi":"DELETE /wa/instances/{instance_id}/groups/{group_id}/participants","href":"/pt-BR/v1/api-reference/groups/delete-participants"},{"title":"Rebaixar Participantes","openapi":"DELETE /wa/instances/{instance_id}/groups/{group_id}/demote-participants","href":"/pt-BR/v1/api-reference/groups/demote-participants"},{"title":"Entrar em Grupos","openapi":"POST /wa/instances/{instance_id}/groups/join","href":"/pt-BR/v1/api-reference/groups/join-group"},{"title":"Promover Participantes","openapi":"POST /wa/instances/{instance_id}/groups/{group_id}/promote-participants","href":"/pt-BR/v1/api-reference/groups/promote-participants"}]},{"group":"Utilidades","pages":[{"title":"Verificação de Número (Sem Instância)","openapi":"GET /wa/recipients/{recipient}","href":"/pt-BR/v1/api-reference/utils/check-recipient"},{"title":"Verificação de Números em Lote (Sem Instância)","openapi":"POST /wa/recipients/batch","href":"/pt-BR/v1/api-reference/utils/check-recipient-batch"},{"title":"Verificação de Número","openapi":"GET /wa/instances/{instance_id}/recipients/{recipient}","href":"/pt-BR/v1/api-reference/utils/fetch-recipient"},{"title":"Verificação de Números em Lote","openapi":"POST /wa/instances/{instance_id}/recipients/batch","href":"/pt-BR/v1/api-reference/utils/fetch-recipient-batch"},{"title":"Atualização de Presença","openapi":"PATCH /wa/instances/{instance_id}/presence","href":"/pt-BR/v1/api-reference/utils/presence-update"},{"title":"Foto de Perfil do Destinatário","openapi":"GET /wa/recipients/{recipient}/pp","href":"/pt-BR/v1/api-reference/utils/recipient-profile-picture"}]}]},{"tab":"CLI","icon":"terminal","pages":[{"title":"CLI","href":"/pt-BR/v1/cli/introduction"}]},{"tab":"Blog","icon":"newspaper","href":"https://blog.zapsterapi.com/?utm_source=Documentation\u0026utm_medium=DropdownNavigation"}]},{"language":"en","pages":[{"title":"en","href":"/en/v1/introduction"}]}]},"basePath":"","title":"Enviando Mensagens - Zapster API","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a74be98ba7","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BgGj2PGS.js","utils-BhNOqRKb.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BAgRNUZo.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CGkb0TPw.js","snippetPresets-ChLkL1a6.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-Ef10Jrbx.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DlVCnjU8.js","shallow-BA55zJxQ.js","getApiPlaygroundDisplay-DR09dKtp.js","CodeSnippet-BZ8J8Kll.js","CodeSnippets-CcguVheG.js","Page-C7x-eUfk.js","getPastedJson-D5UqeqBp.js","icon-DpD0l99C.js","MethodPill-Wg2NXsp_.js","DuplicateIcon-CCSyX8lh.js","createIcon-C4Ukv9HX.js","DynamicMarkdown-RhjEuCHC.js","SectionHeading-DL1MykRq.js","axios-vUo_bRtp.js","zoom-image-lightbox-CkI5al_8.js","lightbox-handle-r17bVUz3.js","Markdown-BwQ4RMdp.js","dist-CiVXVcSh.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-Dic2Jtb2.js"]}