{
"errors": [
{
"code": "instance_update_required",
"message": "This instance is running an older version that does not support this feature. Power the instance off and on to update it, or contact support for help."
}
]
}
Instâncias
Atualizando Configurações
Atualiza as configurações de comportamento da instância. Envie apenas o que quer mudar: tudo o que ficar de fora continua exatamente como está.
{
"errors": [
{
"code": "instance_update_required",
"message": "This instance is running an older version that does not support this feature. Power the instance off and on to update it, or contact support for help."
}
]
}
Use este endpoint para atualizar as configurações de comportamento da sua instância: rejeição de ligações, delay antes do envio de mensagens, presença (online/digitando), limpeza de conversa e confirmação de leitura automática.
Você não precisa enviar todas as configurações a cada chamada. Envie apenas o que quer mudar e tudo o que ficar de fora continua exatamente como está.Isso vale até para configurações com subcampos, como message_delay e o formato segmentado de read_confirmation: cada subcampo que você não enviar também fica como estava. Por exemplo, enviando apenas:
call_rejection: define se ligações recebidas devem ser rejeitadas automaticamente. Aceita all (rejeita todas), none (não rejeita nenhuma), video_only (rejeita apenas chamadas de vídeo) ou audio_only (rejeita apenas chamadas de áudio).
message_delay: adiciona um atraso proposital antes do envio de cada mensagem, útil para simular um comportamento mais humano. É um objeto com enabled (liga/desliga o delay), min e max (limites em segundos, o tempo real é sorteado dentro desse intervalo).
delay_per_word: quando ligado, o delay antes do envio passa a ser calculado com base na quantidade de palavras da mensagem, até um teto de 10 segundos. Quando message_delay está configurado, ele tem prioridade e delay_per_word é ignorado.
presence_behavior: controla quando a instância aparece como “online” ou “digitando” para os contatos. only_composing exibe apenas “Digitando…” durante o envio, sem marcar a conta como online (recomendado); always_online mantém a conta sempre online — atenção: isso pode suprimir as notificações do WhatsApp no celular onde o número está instalado, já que o WhatsApp entende que a conta está em uso em outro dispositivo; always_offline nunca aparece online nem exibe “Digitando…”.
delete_chat_after_sent: quando ligado, limpa a conversa no aparelho logo depois do envio da mensagem, para evitar acúmulo de histórico no dispositivo conectado.
read_confirmation: controla a confirmação de leitura automática das mensagens recebidas. Aceita os valores never (nunca confirma) ou always (sempre confirma), ou um objeto segmentado por tipo de conversa com os campos chats, groups e status, cada um booleano e independente. Quando o segmento status está ligado, os status publicados pelos seus contatos são marcados como vistos assim que recebidos. Mensagens enviadas pela própria instância, listas de transmissão e publicações de canais nunca recebem confirmação automática, independentemente dessa configuração.
Se você precisa de controle fino sobre o momento exato da confirmação de leitura, por exemplo, marcar como lida só depois que um atendente responder, desligue a confirmação automática do segmento desejado e use o endpoint de leitura sob demanda para confirmar mensagem por mensagem.A atualização é aplicada à instância em tempo real, sem necessidade de reiniciá-la.
{"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":""},"chroma":{"liveDeploymentHistoryId":"6ae129f0a0016dd52b435656","collectionId":"84f617dc-1a5c-4cd4-88d4-2529d3a8d2a2","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae129f0a0016dd52b435656"},"entitlements":{},"buildId":"6ae129f0a0016dd52b435656","clientVersion":"0.0.4021","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":"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":"per-site-search-delta","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":"editor-private-page-search","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":"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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"pt-BR/v1/api-reference/instance/update-settings","slug":"/pt-BR/v1/api-reference/instance/update-settings","pageMetadata":{"title":"Atualizando Configurações","openapi":"PATCH /wa/instances/{instance_id}/settings","description":"Atualiza as configurações de comportamento da instância. Envie apenas o que quer mudar: tudo o que ficar de fora continua exatamente como está.\n","href":"/pt-BR/v1/api-reference/instance/update-settings"},"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: \"Atualiza as configurações de comportamento da instância. Envie apenas o que quer mudar: tudo o que ficar de fora continua exatamente como está.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Use este endpoint para atualizar as configurações de comportamento da sua instância: rejeição de ligações, delay antes do envio de mensagens, presença (online/digitando), limpeza de conversa e confirmação de leitura automática.`}),`\n`,_jsx(Heading,{level:`3`,id:`atualize-só-o-que-precisar`,children:`Atualize só o que precisar`}),`\n`,_jsx(_components.p,{children:`Você não precisa enviar todas as configurações a cada chamada. Envie apenas o que quer mudar e tudo o que ficar de fora continua exatamente como está.`}),`\n`,_jsxs(_components.p,{children:[`Isso vale até para configurações com subcampos, como `,_jsx(_components.code,{children:`message_delay`}),` e o formato segmentado de `,_jsx(_components.code,{children:`read_confirmation`}),`: cada subcampo que você não enviar também fica como estava. Por exemplo, enviando apenas:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"settings\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"read_confirmation\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"chats\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Você liga a confirmação de leitura automática só para conversas individuais, e `,_jsx(_components.code,{children:`groups`}),` e `,_jsx(_components.code,{children:`status`}),` seguem do jeito que estavam.`]}),`\n`,_jsx(Heading,{level:`3`,id:`configurações-disponíveis`,children:`Configurações disponíveis`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`call_rejection`})}),`: define se ligações recebidas devem ser rejeitadas automaticamente. Aceita `,_jsx(_components.code,{children:`all`}),` (rejeita todas), `,_jsx(_components.code,{children:`none`}),` (não rejeita nenhuma), `,_jsx(_components.code,{children:`video_only`}),` (rejeita apenas chamadas de vídeo) ou `,_jsx(_components.code,{children:`audio_only`}),` (rejeita apenas chamadas de áudio).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`message_delay`})}),`: adiciona um atraso proposital antes do envio de cada mensagem, útil para simular um comportamento mais humano. É um objeto com `,_jsx(_components.code,{children:`enabled`}),` (liga/desliga o delay), `,_jsx(_components.code,{children:`min`}),` e `,_jsx(_components.code,{children:`max`}),` (limites em segundos, o tempo real é sorteado dentro desse intervalo).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`delay_per_word`})}),`: quando ligado, o delay antes do envio passa a ser calculado com base na quantidade de palavras da mensagem, até um teto de 10 segundos. Quando `,_jsx(_components.code,{children:`message_delay`}),` está configurado, ele tem prioridade e `,_jsx(_components.code,{children:`delay_per_word`}),` é ignorado.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`presence_behavior`})}),`: controla quando a instância aparece como “online” ou “digitando” para os contatos. `,_jsx(_components.code,{children:`only_composing`}),` exibe apenas “Digitando…” durante o envio, sem marcar a conta como online (recomendado); `,_jsx(_components.code,{children:`always_online`}),` mantém a conta sempre online — atenção: isso pode suprimir as notificações do WhatsApp no celular onde o número está instalado, já que o WhatsApp entende que a conta está em uso em outro dispositivo; `,_jsx(_components.code,{children:`always_offline`}),` nunca aparece online nem exibe “Digitando…”.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`delete_chat_after_sent`})}),`: quando ligado, limpa a conversa no aparelho logo depois do envio da mensagem, para evitar acúmulo de histórico no dispositivo conectado.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`read_confirmation`})}),`: controla a confirmação de leitura automática das mensagens recebidas. Aceita os valores `,_jsx(_components.code,{children:`never`}),` (nunca confirma) ou `,_jsx(_components.code,{children:`always`}),` (sempre confirma), ou um objeto segmentado por tipo de conversa com os campos `,_jsx(_components.code,{children:`chats`}),`, `,_jsx(_components.code,{children:`groups`}),` e `,_jsx(_components.code,{children:`status`}),`, cada um booleano e independente. Quando o segmento `,_jsx(_components.code,{children:`status`}),` está ligado, os status publicados pelos seus contatos são marcados como vistos assim que recebidos. Mensagens enviadas pela própria instância, listas de transmissão e publicações de canais nunca recebem confirmação automática, independentemente dessa configuração.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Se você precisa de controle fino sobre o momento exato da confirmação de leitura, por exemplo, marcar como lida só depois que um atendente responder, desligue a confirmação automática do segmento desejado e use o endpoint de `,_jsx(_components.a,{href:`/pt-BR/v1/api-reference/messages/read-message`,children:`leitura sob demanda`}),` para confirmar mensagem por mensagem.`]}),`\n`,_jsx(_components.p,{children:`A atualização é aplicada à instância em tempo real, sem necessidade de reiniciá-la.`})]})}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":"Atualizando Configurações","openapi":"PATCH /wa/instances/{instance_id}/settings","description":"Atualiza as configurações de comportamento da instância. Envie apenas o que quer mudar: tudo o que ficar de fora continua exatamente como está.\n","href":"/pt-BR/v1/api-reference/instance/update-settings"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Atualize só o que precisar","slug":"atualize-só-o-que-precisar","depth":3,"children":[]},{"title":"Configurações disponíveis","slug":"configurações-disponíveis","depth":3,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/zapsterapi/d763f142efc774ff/watch-openapi.js"],"openApiReferenceData":{"operation":{"summary":"Atualização de Configurações","deprecated":false,"description":"Atualiza as configurações de comportamento da instância. Envie apenas o que quer mudar: tudo o que ficar de fora continua exatamente como está.\n","tags":[],"security":["09020ebb-2867-4ac3-8c77-9828ffa4d5a4"],"parameters":["4ec0bd8f-378c-4b35-9dee-99f00a32615b"],"requestBody":"bdbbdc5a-08ca-46e4-abe4-be5f92bc8a25","responses":{"200":"3ff917f9-0c11-4c30-ac9f-950c352ea66f","400":"4a4bf236-4700-4c8e-883d-98098762cf3b","404":"cc8f06dc-f80c-4253-b92e-bdbaa7d65497","412":"6cd4fb33-cbc3-4aa8-8c2a-0eede87b6087"},"method":"patch","type":"path","servers":["47a9c70c-c4df-478d-b870-e68c65cdee2a"],"path":"/wa/instances/{instance_id}/settings","baseUrlOptions":["https://api.zapsterapi.com/v1"],"title":"Atualização de Configurações","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"4ec0bd8f-378c-4b35-9dee-99f00a32615b":{"name":"instance_id","in":"path","description":"ID da instância.","required":true,"example":"ozj35qv418rpmlrb","schema":{"type":"string","isRequired":true,"description":"ID da instância.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"settings":{"type":"object","description":"Objeto **opcional** de configurações da sua instância.\n","properties":{"call_rejection":{"type":"string","description":"Define o comportarmento de rejeição de ligações.\n\n- `all` - Irá rejeitar todas ligações\n- `none` - Não irá rejeitar ligações.\n- `video_only` - Irá rejeitar apenas ligações de **vídeo**.\n- `audio_only` - Irá rejeitar apenas ligações de **audio**.\n","enum":["all","none","video_only","audio_only"],"uniqueKey":"settings.call_rejection","typeLabel":"enum\u003cstring>"},"delay_per_word":{"type":"boolean","description":"Define se o delay antes de enviar a mensagem deve ser baseado na quantidade de palavras.\n\nℹ️ Limitado a no máximo **10 segundos** de espera.\n","uniqueKey":"settings.delay_per_word","typeLabel":"boolean"},"delete_chat_after_sent":{"type":"boolean","description":"⚠️ *Esta função não está funcionando adequadamente, estamos trabalhando para regulariza-la.*\n\nDefine se o chat/conversa deve ser limpo depois do envio da mensagem. Isso garante que o dispositivo fique acumulando mensagens a ponto de muitas vezes travar o dispositivo que foi conectado.\n","uniqueKey":"settings.delete_chat_after_sent","typeLabel":"boolean"},"message_delay":{"type":"object","description":"Define a configuração de delay antes do envio da mensagem, se configurado `delay_per_word` é ignorado. O tempo é gerado randomicamente entre os limites configurado (`min` e `max`).\n","properties":{"enabled":{"type":"boolean","default":true,"uniqueKey":"settings.message_delay.enabled","typeLabel":"boolean"},"max":{"type":"integer","description":"Máximo de tempo em segundos que deve ser esperado antes do envio da mensagem.","default":10,"uniqueKey":"settings.message_delay.max","typeLabel":"integer"},"min":{"type":"integer","description":"Mínimo de tempo em segundos que deve ser esperado antes do envio da mensagem.","default":1,"uniqueKey":"settings.message_delay.min","typeLabel":"integer"}},"uniqueKey":"settings.message_delay","typeLabel":"object"},"presence_behavior":{"type":"string","description":"Define o comportamento da presença (Online, Digitando..., Gravando...) da sua instância.\n\n- `only_composing` - Exibe \"Digitando...\" durante o envio das mensagens, sem marcar a conta como \"Online\". (**recomendado**)\n- `always_online` - A conta aparece sempre \"Online\". Atenção: enquanto a conta está \"Online\" por um dispositivo vinculado, o WhatsApp pode deixar de enviar notificações para o celular onde o número está instalado.\n- `always_offline` - Nunca aparece \"Online\" e não exibe \"Digitando...\" durante os envios.\n","enum":["only_composing","always_online","always_offline"],"uniqueKey":"settings.presence_behavior","typeLabel":"enum\u003cstring>"},"read_confirmation":{"oneOf":[{"type":"string","description":"Define o comportamento de \"confirmação de leitura\", ou seja, a leitura automática das mensagens recebidas.\n\nAceita os valores clássicos em texto ou um objeto segmentado por tipo de conversa:\n\n- `never` - Nunca confirma a leitura (equivale a todos os segmentos desligados)\n- `always` - Sempre confirma a leitura (equivale a todos os segmentos ligados)\n- Objeto com os campos `chats`, `groups` e `status` - Controla cada segmento de forma independente\n\nNo formato de objeto, cada campo é booleano e o padrão é `false`:\n\n- `chats` - Conversas individuais\n- `groups` - Grupos\n- `status` - Status publicados pelos seus contatos (com este segmento ligado, os status recebidos são marcados como vistos)\n\nMensagens enviadas pela própria instância, listas de transmissão e publicações de canais nunca recebem confirmação de leitura automática.\n","enum":["never","always"],"uniqueKey":"settings.read_confirmation.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"object","description":"Define o comportamento de \"confirmação de leitura\", ou seja, a leitura automática das mensagens recebidas.\n\nAceita os valores clássicos em texto ou um objeto segmentado por tipo de conversa:\n\n- `never` - Nunca confirma a leitura (equivale a todos os segmentos desligados)\n- `always` - Sempre confirma a leitura (equivale a todos os segmentos ligados)\n- Objeto com os campos `chats`, `groups` e `status` - Controla cada segmento de forma independente\n\nNo formato de objeto, cada campo é booleano e o padrão é `false`:\n\n- `chats` - Conversas individuais\n- `groups` - Grupos\n- `status` - Status publicados pelos seus contatos (com este segmento ligado, os status recebidos são marcados como vistos)\n\nMensagens enviadas pela própria instância, listas de transmissão e publicações de canais nunca recebem confirmação de leitura automática.\n","properties":{"chats":{"type":"boolean","default":false,"description":"Confirma a leitura de mensagens recebidas em conversas individuais.","uniqueKey":"settings.read_confirmation.oneOf.1.chats","typeLabel":"boolean"},"groups":{"type":"boolean","default":false,"description":"Confirma a leitura de mensagens recebidas em grupos.","uniqueKey":"settings.read_confirmation.oneOf.1.groups","typeLabel":"boolean"},"status":{"type":"boolean","default":false,"description":"Marca como vistos os status publicados pelos seus contatos.","uniqueKey":"settings.read_confirmation.oneOf.1.status","typeLabel":"boolean"}},"uniqueKey":"settings.read_confirmation.oneOf.1","typeLabel":"object"}],"uniqueKey":"settings.read_confirmation","typeLabel":"enum\u003cstring> | object"}},"uniqueKey":"settings","typeLabel":"object"}},"example":{"settings":{"read_confirmation":{"chats":true}}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"settings":{"read_confirmation":{"chats":true}}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"3ff917f9-0c11-4c30-ac9f-950c352ea66f":{"description":"Success","content":{"application/json":{"schema":{"type":"object","description":"Estrutura de uma instância registrada na API.","properties":{"created_at":{"type":"string","format":"date-time","description":"Data e hora de criação da instância no formato ISO 8601.","example":"2024-10-03T21:56:22.620Z","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"id":{"type":"string","description":"Identificador único da instância.","example":"xy9rexnkwobmgg3tehgvs","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"metadata":{"type":"object","description":"Metadados adicionais armazenados como chave e valor.","additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"metadata.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"number","uniqueKey":"metadata.additionalProperties.oneOf.1","typeLabel":"number"}],"uniqueKey":"metadata.additionalProperties","typeLabel":"string | number"},"example":{"customer_id":"123456","customer_name":"Joãozinho","phone_number":"+5587989075555"},"isRequired":true,"uniqueKey":"metadata","typeLabel":"object"},"name":{"type":"string","description":"Nome da instância.","example":"MyNewInstance2","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"owner":{"type":"object","description":"Informações sobre o proprietário da instância.","properties":{"id":{"type":"string","format":"uuid","description":"Identificador único do proprietário.","isRequired":true,"uniqueKey":"owner.id","typeLabel":"string\u003cuuid>"},"display_name":{"oneOf":[{"type":"string","description":"Nome de exibição do proprietário. Pode ser nulo.","example":null,"uniqueKey":"owner.display_name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Nome de exibição do proprietário. Pode ser nulo.","example":null,"uniqueKey":"owner.display_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner.display_name","typeLabel":"string | null"}},"required":["id"],"isRequired":true,"uniqueKey":"owner","typeLabel":"object"},"settings":{"type":"object","description":"Objeto **opcional** de configurações da sua instância.\n","properties":{"call_rejection":{"type":"string","description":"Define o comportarmento de rejeição de ligações.\n\n- `all` - Irá rejeitar todas ligações\n- `none` - Não irá rejeitar ligações.\n- `video_only` - Irá rejeitar apenas ligações de **vídeo**.\n- `audio_only` - Irá rejeitar apenas ligações de **audio**.\n","enum":["all","none","video_only","audio_only"],"uniqueKey":"settings.call_rejection","typeLabel":"enum\u003cstring>"},"delay_per_word":{"type":"boolean","description":"Define se o delay antes de enviar a mensagem deve ser baseado na quantidade de palavras.\n\nℹ️ Limitado a no máximo **10 segundos** de espera.\n","uniqueKey":"settings.delay_per_word","typeLabel":"boolean"},"delete_chat_after_sent":{"type":"boolean","description":"⚠️ *Esta função não está funcionando adequadamente, estamos trabalhando para regulariza-la.*\n\nDefine se o chat/conversa deve ser limpo depois do envio da mensagem. Isso garante que o dispositivo fique acumulando mensagens a ponto de muitas vezes travar o dispositivo que foi conectado.\n","uniqueKey":"settings.delete_chat_after_sent","typeLabel":"boolean"},"message_delay":{"type":"object","description":"Define a configuração de delay antes do envio da mensagem, se configurado `delay_per_word` é ignorado. O tempo é gerado randomicamente entre os limites configurado (`min` e `max`).\n","properties":{"enabled":{"type":"boolean","default":true,"uniqueKey":"settings.message_delay.enabled","typeLabel":"boolean"},"max":{"type":"integer","description":"Máximo de tempo em segundos que deve ser esperado antes do envio da mensagem.","default":10,"uniqueKey":"settings.message_delay.max","typeLabel":"integer"},"min":{"type":"integer","description":"Mínimo de tempo em segundos que deve ser esperado antes do envio da mensagem.","default":1,"uniqueKey":"settings.message_delay.min","typeLabel":"integer"}},"uniqueKey":"settings.message_delay","typeLabel":"object"},"presence_behavior":{"type":"string","description":"Define o comportamento da presença (Online, Digitando..., Gravando...) da sua instância.\n\n- `only_composing` - Exibe \"Digitando...\" durante o envio das mensagens, sem marcar a conta como \"Online\". (**recomendado**)\n- `always_online` - A conta aparece sempre \"Online\". Atenção: enquanto a conta está \"Online\" por um dispositivo vinculado, o WhatsApp pode deixar de enviar notificações para o celular onde o número está instalado.\n- `always_offline` - Nunca aparece \"Online\" e não exibe \"Digitando...\" durante os envios.\n","enum":["only_composing","always_online","always_offline"],"uniqueKey":"settings.presence_behavior","typeLabel":"enum\u003cstring>"},"read_confirmation":{"oneOf":[{"type":"string","description":"Define o comportamento de \"confirmação de leitura\", ou seja, a leitura automática das mensagens recebidas.\n\nAceita os valores clássicos em texto ou um objeto segmentado por tipo de conversa:\n\n- `never` - Nunca confirma a leitura (equivale a todos os segmentos desligados)\n- `always` - Sempre confirma a leitura (equivale a todos os segmentos ligados)\n- Objeto com os campos `chats`, `groups` e `status` - Controla cada segmento de forma independente\n\nNo formato de objeto, cada campo é booleano e o padrão é `false`:\n\n- `chats` - Conversas individuais\n- `groups` - Grupos\n- `status` - Status publicados pelos seus contatos (com este segmento ligado, os status recebidos são marcados como vistos)\n\nMensagens enviadas pela própria instância, listas de transmissão e publicações de canais nunca recebem confirmação de leitura automática.\n","enum":["never","always"],"uniqueKey":"settings.read_confirmation.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"object","description":"Define o comportamento de \"confirmação de leitura\", ou seja, a leitura automática das mensagens recebidas.\n\nAceita os valores clássicos em texto ou um objeto segmentado por tipo de conversa:\n\n- `never` - Nunca confirma a leitura (equivale a todos os segmentos desligados)\n- `always` - Sempre confirma a leitura (equivale a todos os segmentos ligados)\n- Objeto com os campos `chats`, `groups` e `status` - Controla cada segmento de forma independente\n\nNo formato de objeto, cada campo é booleano e o padrão é `false`:\n\n- `chats` - Conversas individuais\n- `groups` - Grupos\n- `status` - Status publicados pelos seus contatos (com este segmento ligado, os status recebidos são marcados como vistos)\n\nMensagens enviadas pela própria instância, listas de transmissão e publicações de canais nunca recebem confirmação de leitura automática.\n","properties":{"chats":{"type":"boolean","default":false,"description":"Confirma a leitura de mensagens recebidas em conversas individuais.","uniqueKey":"settings.read_confirmation.oneOf.1.chats","typeLabel":"boolean"},"groups":{"type":"boolean","default":false,"description":"Confirma a leitura de mensagens recebidas em grupos.","uniqueKey":"settings.read_confirmation.oneOf.1.groups","typeLabel":"boolean"},"status":{"type":"boolean","default":false,"description":"Marca como vistos os status publicados pelos seus contatos.","uniqueKey":"settings.read_confirmation.oneOf.1.status","typeLabel":"boolean"}},"uniqueKey":"settings.read_confirmation.oneOf.1","typeLabel":"object"}],"uniqueKey":"settings.read_confirmation","typeLabel":"enum\u003cstring> | object"}},"isRequired":true,"uniqueKey":"settings","typeLabel":"object"},"status":{"type":"string","enum":["connected","disconnected","offline"],"description":"Status atual da instância","example":"disconnected","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"webhooks":{"type":"array","description":"Lista de webhooks configurados para esta instância.","items":{"type":"object","description":"Configuração de um webhook associado à instância.","properties":{"enabled":{"type":"boolean","description":"Indica se o webhook está ativado.","example":true,"isRequired":true,"uniqueKey":"webhooks.items.[INDEX].enabled","typeLabel":"boolean"},"events":{"type":"array","description":"Lista de eventos que acionam este webhook.","items":{"type":"string","enum":["call.accepted","call.missed","call.received","call.rejected","group.created","group.participants_added","group.participants_demoted","group.participants_promoted","group.participants_removed","group.updated","instance.connected","instance.disconnected","instance.forbidden","instance.mentioned","instance.qrcode","instance.restricted","instance.restriction_lifted","message.deleted","message.delivered","message.edited","message.failed","message.flow_reply","message.pinned","message.reaction","message.read","message.received","message.sent","message.unpinned","poll.created","poll.deleted","poll.updated","status.reply"],"uniqueKey":"webhooks.items.[INDEX].events.items.[INDEX]","typeLabel":"enum\u003cstring>"},"example":["message.received"],"isRequired":true,"uniqueKey":"webhooks.items.[INDEX].events","typeLabel":"enum\u003cstring>[]"},"id":{"type":"string","description":"Identificador único do webhook.","example":"2nenz69l0xbf0m3uu9tfo","isRequired":true,"uniqueKey":"webhooks.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","description":"Nome do webhook configurado.","example":"Webhook Name","isRequired":true,"uniqueKey":"webhooks.items.[INDEX].name","typeLabel":"string"},"test_mode":{"type":"boolean","description":"Indica se o webhook está em modo de teste.","example":false,"isRequired":true,"uniqueKey":"webhooks.items.[INDEX].test_mode","typeLabel":"boolean"},"url":{"type":"string","format":"uri","description":"URL do webhook para onde os eventos serão enviados.","example":"https://webhook.mydomain.com","isRequired":true,"uniqueKey":"webhooks.items.[INDEX].url","typeLabel":"string\u003curi>"},"test_url":{"oneOf":[{"type":"string","description":"URL de teste do webhook, se disponível.","example":null,"uniqueKey":"webhooks.items.[INDEX].test_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"URL de teste do webhook, se disponível.","example":null,"uniqueKey":"webhooks.items.[INDEX].test_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"webhooks.items.[INDEX].test_url","typeLabel":"string | null"}},"required":["enabled","events","id","name","test_mode","url"],"uniqueKey":"webhooks.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"webhooks","typeLabel":"object[]"},"connection_type":{"type":"string","enum":["unofficial","waba"],"description":"Tipo de conexão da instância:\n- `unofficial`: conexão via QR code (padrão)\n- `waba`: conexão via API oficial do WhatsApp (Cloud API da Meta)\n","example":"unofficial","uniqueKey":"connection_type","typeLabel":"enum\u003cstring>"},"qrcode":{"oneOf":[{"type":"string","description":"QR Code da instância, caso disponível.","example":null,"uniqueKey":"qrcode.oneOf.0","typeLabel":"string"},{"type":"null","description":"QR Code da instância, caso disponível.","example":null,"uniqueKey":"qrcode.oneOf.1","typeLabel":"null"}],"uniqueKey":"qrcode","typeLabel":"string | null"},"lookup_key":{"type":"string","description":"Identificador de pesquisa criado anteriormente.","example":"ins_8j7wlxmpjlixx9mux5","uniqueKey":"lookup_key","typeLabel":"string"}},"required":["created_at","id","metadata","name","owner","settings","status","webhooks"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"created_at":"2024-10-03T21:56:22.620Z","id":"xy9rexnkwobmgg3tehgvs","metadata":{"customer_id":"123456","customer_name":"Joãozinho","phone_number":"+5587989075555"},"name":"MyNewInstance2","owner":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","display_name":null},"settings":{"call_rejection":"all","delay_per_word":true,"delete_chat_after_sent":true,"message_delay":{"enabled":true,"max":10,"min":1},"presence_behavior":"only_composing","read_confirmation":"never"},"status":"disconnected","webhooks":[{"enabled":true,"events":["message.received"],"id":"2nenz69l0xbf0m3uu9tfo","name":"Webhook Name","test_mode":false,"url":"https://webhook.mydomain.com","test_url":null}],"connection_type":"unofficial","qrcode":null,"lookup_key":"ins_8j7wlxmpjlixx9mux5"}}},"exampleType":"generated"}},"exampleType":"generated"},"4a4bf236-4700-4c8e-883d-98098762cf3b":{"description":"Erro de validação no corpo da requisição","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código do erro de validação","example":"invalid_enum_value","uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","description":"Mensagem de erro","example":"Invalid enum value. Expected 'all' | 'none' | 'video_only' | 'audio_only'","uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"path":{"type":"string","description":"Caminho do campo inválido no corpo da requisição","example":"settings.call_rejection","uniqueKey":"errors.items.[INDEX].path","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"code":"invalid_enum_value","message":"Invalid enum value. Expected 'all' | 'none' | 'video_only' | 'audio_only'","path":"settings.call_rejection"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"cc8f06dc-f80c-4253-b92e-bdbaa7d65497":{"description":"Instância não encontrada ou não pertence ao usuário","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","example":"instance_not_found","uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","example":"Instance not found.","uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"code":"instance_not_found","message":"Instance not found."}]}}},"exampleType":"generated"}},"exampleType":"generated"},"6cd4fb33-cbc3-4aa8-8c2a-0eede87b6087":{"description":"A instância precisa ser atualizada para suportar a configuração enviada","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","example":"instance_update_required","uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","example":"This instance is running an older version that does not support this feature. Power the instance off and on to update it, or contact support for help.","uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"code":"instance_update_required","message":"This instance is running an older version that does not support this feature. Power the instance off and on to update it, or contact support for help."}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"09020ebb-2867-4ac3-8c77-9828ffa4d5a4":{"bearer":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearer"}}},"servers":{"47a9c70c-c4df-478d-b870-e68c65cdee2a":{"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":"Atualizando Configurações - Zapster API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"pt-BR":{"href":"/pt-BR/v1/api-reference/instance/update-settings","matchLevel":0},"en":{"href":"/en/v1/introduction","matchLevel":4}}},"lastModified":"2026-08-18T10:49:07.034Z","originalFileLocation":"pt-BR/v1/api-reference/instance/update-settings.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=\"description\" content=\"Atualiza as configurações de comportamento da instância. Envie apenas o que quer mudar: tudo o que ficar de fora continua exatamente como está.\">\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=\"Atualizando Configurações - Zapster API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Atualiza as configurações de comportamento da instância. Envie apenas o que quer mudar: tudo o que ficar de fora continua exatamente como está.\">\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/instance/update-settings\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://zapsterapi.mintlify.app/_mintlify/api/og/v2?division=Inst%C3%A2ncias\u0026amp;title=Atualizando+Configura%C3%A7%C3%B5es\u0026amp;description=Atualiza+as+configura%C3%A7%C3%B5es+de+comportamento+da+inst%C3%A2ncia.+Envie+apenas+o+que+quer+mudar%3A+tudo+o+que+ficar+de+fora+continua+exatamente+como+est%C3%A1.%0A\u0026amp;theme=6d793348c5ecf1343e906422\u0026amp;signature=c56febc8723cca23df86131180c3cc2fb83502a6c01970d703a30bb4b743fbc4\">\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=\"Atualizando Configurações - Zapster API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Atualiza as configurações de comportamento da instância. Envie apenas o que quer mudar: tudo o que ficar de fora continua exatamente como está.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://zapsterapi.mintlify.app/_mintlify/api/og/v2?division=Inst%C3%A2ncias\u0026amp;title=Atualizando+Configura%C3%A7%C3%B5es\u0026amp;description=Atualiza+as+configura%C3%A7%C3%B5es+de+comportamento+da+inst%C3%A2ncia.+Envie+apenas+o+que+quer+mudar%3A+tudo+o+que+ficar+de+fora+continua+exatamente+como+est%C3%A1.%0A\u0026amp;theme=6d793348c5ecf1343e906422\u0026amp;signature=c56febc8723cca23df86131180c3cc2fb83502a6c01970d703a30bb4b743fbc4\">\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/instance/update-settings\">\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/instance/update-settings.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/instance/update-settings#webpage\",\"url\":\"https://developer.zapsterapi.com/pt-BR/v1/api-reference/instance/update-settings\",\"name\":\"Atualizando Configurações\",\"description\":\"Atualiza as configurações de comportamento da instância. Envie apenas o que quer mudar: tudo o que ficar de fora continua exatamente como está.\",\"dateModified\":\"2026-08-18T10:49:07.034Z\",\"isPartOf\":{\"@id\":\"https://developer.zapsterapi.com#website\"},\"breadcrumb\":{\"@id\":\"https://developer.zapsterapi.com/pt-BR/v1/api-reference/instance/update-settings#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.zapsterapi.com/pt-BR/v1/api-reference/instance/update-settings#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Instâncias\",\"item\":\"https://developer.zapsterapi.com/pt-BR/v1/api-reference/instance/list-instances\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Atualizando Configurações\",\"item\":\"https://developer.zapsterapi.com/pt-BR/v1/api-reference/instance/update-settings\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developer.zapsterapi.com/pt-BR/v1/api-reference/instance/update-settings#apireference\",\"headline\":\"Atualizando Configurações\",\"name\":\"Atualizando Configurações\",\"description\":\"Atualiza as configurações de comportamento da instância. Envie apenas o que quer mudar: tudo o que ficar de fora continua exatamente como está.\",\"url\":\"https://developer.zapsterapi.com/pt-BR/v1/api-reference/instance/update-settings\",\"mainEntityOfPage\":{\"@id\":\"https://developer.zapsterapi.com/pt-BR/v1/api-reference/instance/update-settings#webpage\"},\"dateModified\":\"2026-08-18T10:49:07.034Z\",\"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\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","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","description":"","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","description":"Emite antecipadamente o token de confirmação que uma ação destrutiva registrada exigiria no header X-Confirmation-Token.\n","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}","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}","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"}]}]},"title":"Atualizando Configurações - Zapster API","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","Page-CT9uE8Ip.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js","Markdown-3OmurJMP.js","clsx-DMKzROTp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-1ms6tsT-.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ke9xIMFx.js"]}