Ao criar uma instância, você escolhe o tipo de conexão:
Não oficial (connection_type: "unofficial"): o padrão. Depois de criar, você conecta via QR code ou código de pareamento.
Oficial WABA (connection_type: "waba"): usa a API oficial da Meta. Você precisa fornecer as credenciais no objeto waba.
Para instâncias WABA, existem duas formas de obter as credenciais:
Embedded Signup (recomendado): fluxo OAuth pelo dashboard, sem precisar mexer no Meta Business Manager. Veja o guia passo a passo.
Token manual: você gera um System User Token no Meta Business Manager e passa direto na API. Veja o método avançado.
Quando connection_type é waba, o objeto waba com access_token, phone_number_id e waba_id é obrigatório. Para instâncias não oficiais, esse campo é ignorado.
Credenciais para conexão com a API oficial do WhatsApp (Cloud API da Meta).
Obrigatório quando connection_type é waba. Ignorado para instâncias não oficiais.
Um identificador único opcional de pesquisa que permite associar sua instância a uma estrutura de dados específica. A Zapster API não utiliza esse dado internamente; ele serve exclusivamente para facilitar consultas na API, permitindo localizar registros mais rapidamente por meio deste parâmetro de pesquisa.
Um conjunto de informações adicionais armazenadas como chave e valor. Cada chave é um texto e o valor pode ser um número ou um texto. Esse campo é opcional e pode ser usado para guardar detalhes personalizados.
Para números de telefone, use o formato E.164 (ex: +5587989075555). O sistema validará e formatará automaticamente o número, removendo espaços e hífens.
Lista de webhooks serão criados assim que a instância finalizar sua criação. Atente-se para a quantidade de webhooks nesta lista, a mesma é baseada no seu plano contratado.
{"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.4067","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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"pt-BR/v1/api-reference/instance/create-instance","slug":"/pt-BR/v1/api-reference/instance/create-instance","pageMetadata":{"title":"Criando Instância","openapi":"POST /wa/instances","description":"","href":"/pt-BR/v1/api-reference/instance/create-instance"},"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`,ol:`ol`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Note}=_components;if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Ao criar uma instância, você escolhe o tipo de conexão:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Não oficial`}),` (`,_jsx(_components.code,{children:`connection_type: \"unofficial\"`}),`): o padrão. Depois de criar, você conecta via QR code ou código de pareamento.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Oficial WABA`}),` (`,_jsx(_components.code,{children:`connection_type: \"waba\"`}),`): usa a API oficial da Meta. Você precisa fornecer as credenciais no objeto `,_jsx(_components.code,{children:`waba`}),`.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Para instâncias WABA, existem duas formas de obter as credenciais:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Embedded Signup`}),` (recomendado): fluxo OAuth pelo dashboard, sem precisar mexer no Meta Business Manager. Veja o `,_jsx(_components.a,{href:`/pt-BR/v1/guides/connect-waba-instance`,children:`guia passo a passo`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Token manual`}),`: você gera um System User Token no Meta Business Manager e passa direto na API. Veja o `,_jsx(_components.a,{href:`/pt-BR/v1/guides/connect-waba-instance#m%C3%A9todo-2-token-manual-avan%C3%A7ado`,children:`método avançado`}),`.`]}),`\n`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Quando `,_jsx(_components.code,{children:`connection_type`}),` é `,_jsx(_components.code,{children:`waba`}),`, o objeto `,_jsx(_components.code,{children:`waba`}),` com `,_jsx(_components.code,{children:`access_token`}),`, `,_jsx(_components.code,{children:`phone_number_id`}),` e `,_jsx(_components.code,{children:`waba_id`}),` é obrigatório. Para instâncias não oficiais, esse campo é ignorado.`]})}),`\n`,_jsxs(_components.p,{children:[`Para entender as diferenças entre os dois tipos, veja o `,_jsx(_components.a,{href:`/pt-BR/v1/guides/waba-vs-unofficial`,children:`comparativo WABA vs não oficial`}),`.`]})]})}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":"Criando Instância","openapi":"POST /wa/instances","description":"","href":"/pt-BR/v1/api-reference/instance/create-instance"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/zapsterapi/d763f142efc774ff/watch-openapi.js"],"openApiReferenceData":{"operation":{"summary":"Criação de Instâncias","deprecated":false,"description":"","tags":[],"security":["91298441-0a88-4a0b-b981-2fea009d7de6"],"requestBody":"887bbd14-c1f2-463e-9713-85a3508a5d41","responses":{"200":"91efcd87-bf61-484f-b662-1f588e5ee06a"},"method":"post","type":"path","servers":["47a9c70c-c4df-478d-b870-e68c65cdee2a"],"path":"/wa/instances","baseUrlOptions":["https://api.zapsterapi.com/v1"],"title":"Criação de Instâncias","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"connection_type":{"type":"string","enum":["unofficial","waba"],"default":"unofficial","description":"Tipo de conexão da instância:\n- `unofficial` (padrão): conexão via QR code ou código de pareamento\n- `waba`: conexão via API oficial do WhatsApp (Cloud API da Meta)\n\nQuando `waba` é selecionado, o objeto `waba` com as credenciais é obrigatório.\n","example":"unofficial","uniqueKey":"connection_type","typeLabel":"enum\u003cstring>"},"waba":{"type":"object","description":"Credenciais para conexão com a API oficial do WhatsApp (Cloud API da Meta).\nObrigatório quando `connection_type` é `waba`. Ignorado para instâncias não oficiais.\n","properties":{"access_token":{"type":"string","description":"Token de acesso da Meta Cloud API. Pode ser um System User Token\n(gerado no Meta Business Manager) ou obtido via Embedded Signup (OAuth).\n","example":"EAAxxxxxxx...","isRequired":true,"uniqueKey":"waba.access_token","typeLabel":"string"},"phone_number_id":{"type":"string","description":"ID do número de telefone cadastrado na Meta Business Platform","example":"1016102021584086","isRequired":true,"uniqueKey":"waba.phone_number_id","typeLabel":"string"},"waba_id":{"type":"string","description":"ID da conta WhatsApp Business (WABA) na Meta","example":"419378847918255","isRequired":true,"uniqueKey":"waba.waba_id","typeLabel":"string"},"auth_method":{"type":"string","enum":["system_user_token"],"default":"system_user_token","description":"Opcional. Como o `access_token` foi obtido. Aqui o único\nvalor aceito é `system_user_token` (token gerado no Meta\nBusiness Manager), que também é o padrão quando omitido.\n\nEste campo define qual segredo a Zapster usa para validar\na assinatura dos webhooks que a Meta envia. Informe\n`app_secret` junto se o token pertence ao seu próprio app\nMeta, para que a validação seja feita contra ele.\n","example":"system_user_token","uniqueKey":"waba.auth_method","typeLabel":"enum\u003cstring>"},"app_id":{"type":"string","description":"Opcional. ID do app Meta do cliente (BYO-app), quando o\n`access_token` é um System User Token gerado no app Meta do\npróprio cliente. Usado apenas para identificação/auditoria —\nnão é segredo e não participa da validação de assinatura.\n","example":"1234567890123456","uniqueKey":"waba.app_id","typeLabel":"string"},"app_secret":{"type":"string","description":"Opcional, recomendado para BYO-app. App Secret do app Meta\ndo cliente. Quando informado, a assinatura HMAC\n(`X-Hub-Signature-256`) dos webhooks de entrada é validada\ncontra este segredo (em vez do app secret global da\nZapster), garantindo a verificação completa de autenticidade\ndos eventos recebidos.\n\nÉ armazenado criptografado em repouso (AES-256), com o mesmo\nrigor do `access_token`. Informe-o sempre que o\n`access_token` for um System User Token do seu próprio app\nMeta.\n","example":"a1b2c3d4e5f6...","uniqueKey":"waba.app_secret","typeLabel":"string"},"webhook_verify_token":{"type":"string","description":"Opcional. Token de verificação de webhook fornecido pelo\ncliente. Se omitido, a Zapster gera um token aleatório.\nArmazenado criptografado em repouso (AES-256).\n","example":"meu-verify-token","uniqueKey":"waba.webhook_verify_token","typeLabel":"string"}},"required":["access_token","phone_number_id","waba_id"],"uniqueKey":"waba","typeLabel":"object"},"name":{"type":"string","description":"Um apelido opcional para sua instância, usado apenas para sua organização.","maxLength":64,"example":"Bot SDR","uniqueKey":"name","typeLabel":"string"},"lookup_key":{"type":"string","maxLength":36,"example":"ins_8j7wlxmpjlixx9mux5","description":"Um identificador único opcional de pesquisa que permite associar sua instância a uma estrutura de dados específica. A Zapster API não utiliza esse dado internamente; ele serve exclusivamente para facilitar consultas na API, permitindo localizar registros mais rapidamente por meio deste parâmetro de pesquisa.\n","uniqueKey":"lookup_key","typeLabel":"string"},"metadata":{"type":"object","description":"Um conjunto de informações adicionais armazenadas como chave e valor. Cada chave é um texto e o valor pode ser um número ou um texto. Esse campo é opcional e pode ser usado para guardar detalhes personalizados.\n\nPara números de telefone, use o formato E.164 (ex: `+5587989075555`). O sistema validará e formatará automaticamente o número, removendo espaços e hífens.\n","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"},"uniqueKey":"metadata","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"}},"uniqueKey":"settings","typeLabel":"object"},"webhooks":{"type":"object","description":"Lista de webhooks serão criados assim que a instância finalizar sua criação. Atente-se para a quantidade de webhooks nesta lista, a mesma é baseada no seu plano contratado.\n","properties":{"events":{"type":"array","description":"Lista de eventos será enviados para o webhook.\n\nAlguns eventos dependem do tipo de conexão da instância. O `message.failed` e o `message.flow_reply` existem apenas em instâncias com API oficial (WABA); assinar `message.failed` em uma instância não oficial é recusado com `unsupported_webhook_event`. Já o `instance.restricted`, o `instance.restriction_lifted` e os eventos `call.accepted`, `call.missed`, `call.received` e `call.rejected` existem apenas em instâncias não oficiais e são recusados em instâncias WABA. Consulte a página de eventos disponíveis para o detalhamento por evento.\n","items":{"type":"string","example":["message.received"],"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.events.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"webhooks.events","typeLabel":"enum\u003cstring>[]"},"url":{"type":"string","description":"URL para onde deverá ser enviada as notificações de webhook.","format":"uri","isRequired":true,"uniqueKey":"webhooks.url","typeLabel":"string\u003curi>"}},"required":["events","url"],"uniqueKey":"webhooks","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"connection_type":"unofficial","name":"Bot SDR","lookup_key":"ins_8j7wlxmpjlixx9mux5","metadata":{"customer_id":"123456","customer_name":"Joãozinho","phone_number":"+5587989075555"},"settings":{"delay_per_word":true,"delete_chat_after_sent":true,"message_delay":{"enabled":true,"max":10,"min":1}}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"91efcd87-bf61-484f-b662-1f588e5ee06a":{"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"}},"security":{"91298441-0a88-4a0b-b981-2fea009d7de6":{"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":"Criando Instância - Zapster API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"pt-BR":{"href":"/pt-BR/v1/api-reference/instance/create-instance","matchLevel":0},"en":{"href":"/en/v1/introduction","matchLevel":4}}},"lastModified":"2026-03-30T13:13:48.440Z","originalFileLocation":"pt-BR/v1/api-reference/instance/create-instance.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=\"Criando Instância - 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/instance/create-instance\">\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=Criando+Inst%C3%A2ncia\u0026amp;theme=6d793348c5ecf1343e906422\u0026amp;signature=dd831537ba23f0ab87553adf0f17907c4d26f69a7f5c75380f93ab389d42985c\">\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=\"Criando Instância - Zapster API\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://zapsterapi.mintlify.app/_mintlify/api/og/v2?division=Inst%C3%A2ncias\u0026amp;title=Criando+Inst%C3%A2ncia\u0026amp;theme=6d793348c5ecf1343e906422\u0026amp;signature=dd831537ba23f0ab87553adf0f17907c4d26f69a7f5c75380f93ab389d42985c\">\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/create-instance\">\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/create-instance.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/create-instance#webpage\",\"url\":\"https://developer.zapsterapi.com/pt-BR/v1/api-reference/instance/create-instance\",\"name\":\"Criando Instância\",\"dateModified\":\"2026-03-30T13:13:48.440Z\",\"isPartOf\":{\"@id\":\"https://developer.zapsterapi.com#website\"},\"breadcrumb\":{\"@id\":\"https://developer.zapsterapi.com/pt-BR/v1/api-reference/instance/create-instance#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.zapsterapi.com/pt-BR/v1/api-reference/instance/create-instance#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\":\"Criando Instância\",\"item\":\"https://developer.zapsterapi.com/pt-BR/v1/api-reference/instance/create-instance\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developer.zapsterapi.com/pt-BR/v1/api-reference/instance/create-instance#apireference\",\"headline\":\"Criando Instância\",\"name\":\"Criando Instância\",\"url\":\"https://developer.zapsterapi.com/pt-BR/v1/api-reference/instance/create-instance\",\"mainEntityOfPage\":{\"@id\":\"https://developer.zapsterapi.com/pt-BR/v1/api-reference/instance/create-instance#webpage\"},\"dateModified\":\"2026-03-30T13:13:48.440Z\",\"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","description":null,"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}","description":"","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}","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"}]}]},"basePath":"","title":"Criando Instância - Zapster API","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DX1Meug0.js","utils-B_OMIQVC.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChxhRPMa.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CuKvD8Iv.js","snippetPresets-C5d7p2hp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CfHcE8m4.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C1zZV314.js","shallow-CmQhqCJn.js","getApiPlaygroundDisplay-YRo9s1O7.js","CodeSnippet-RN1MTdfk.js","CodeSnippets-DKLPHxJA.js","Page-BAvA99GL.js","getPastedJson-bz0M41mU.js","icon-CsmhpPrv.js","MethodPill-CNGsVE77.js","DuplicateIcon-DilfU_Z2.js","createIcon-BdsYzQck.js","DynamicMarkdown-CbqEDjbV.js","SectionHeading-O6hXpFCN.js","axios-vUo_bRtp.js","Markdown-nKm-uidQ.js","clsx-ClVdStUn.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CIQkMg3R.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ImrFS4Fy.js"]}