O que são instâncias e PODs?

Uma instância representa uma conexão de WhatsApp administrada pela API. O POD é o servidor hospedado que agrupa instâncias, enquanto a conta cliente pode ter uma ou mais empresas associadas. Cada empresa aponta para um endereço de instância e pode reunir vários domínios personalizados no mesmo POD.

Essa divisão ajuda a pensar a operação em camadas: o plano define o teto de instâncias, a empresa organiza o serviço hospedado e o token identifica o acesso de cada instância. Um sistema que atende marcas, departamentos ou operações distintas pode separar as conexões por instância e administrar os domínios que apontam para elas.

Rota O que faz
POST /api/account/instances Cria instância pelo painel para a conta autenticada.
POST /instance/create Cria instância pela API administrativa do POD.
GET /api/account/domain Lista a configuração de domínios da conta.
POST /api/account/domain/apply Solicita a aplicação de um domínio personalizado.
DELETE /api/account/domain/:domainId Remove a associação do domínio indicado.

O painel exige sessão autenticada e e-mail verificado para administrar instâncias e domínios. A rota interna de criação de instância usa admintoken. Essas duas superfícies têm usos e autenticações diferentes: clientes do painel administram recursos da conta, enquanto a rota administrativa é destinada à operação do POD.

Como funcionam limites e preços por plano?

O plano estabelece quantas instâncias podem ser mantidas no POD. Os limites confirmados são 10 no Básico, até 100 no Starter e até 300 no Enterprise. A quota também pode ser configurada no POD, portanto o limite efetivo depende do plano aplicado e da quota configurada.

Plano ou quantidade Limite de instâncias Preço confirmado
Básico, uma instância 1 R$ 27,00/mês
Básico, de 2 a 10 instâncias Até 10 R$ 25,00 por instância/mês
Starter Até 100 R$ 200,00/mês
Enterprise Até 300 R$ 449,99/mês

Os valores foram confirmados em 5 de outubro de 2026. Para o Básico, o valor muda conforme a quantidade: uma instância custa R$ 27,00 por mês, e de duas a dez instâncias cada uma custa R$ 25,00 por mês. Starter e Enterprise são pacotes mensais com seus limites indicados. Não há aqui uma afirmação sobre descontos, trial ou condições diferentes desses valores.

Planeje pela quantidade de conexões simultâneas de que cada área precisa. Uma instância por operação torna mais fácil separar configuração e credenciais, enquanto um pacote maior organiza várias conexões dentro do limite correspondente. O guia de preços da API WhatsApp detalha as faixas e ajuda a comparar um cenário de uso com o orçamento mensal.

Como usar token e proxy por instância?

Cada instância tem seu próprio token. A API autentica as rotas de instância com esse token; o ID da instância não funciona como credencial. Nas chamadas, use o token da instância no mecanismo aceito pela rota, como header token ou Authorization: Bearer. Guarde credenciais separadas no sistema que integra cada conexão, para que um fluxo use a identidade correta.

Cada instância também tem um proxy móvel exclusivo e individual, de operadora TIM ou Claro, incluído no plano. A GoZAP descreve o isolamento do IP por instância: a configuração de proxy está associada à conexão correspondente. Planeje a operação considerando os limites do serviço e os requisitos de comunicação da sua empresa.

No caso de muitas instâncias, registre junto de cada token a empresa, o domínio, o responsável e o fluxo que o utiliza. A documentação sobre proxy dinâmico e modo Mobile aborda configurações de conexão relacionadas. Evite colocar tokens em planilhas compartilhadas, trechos de código públicos ou mensagens de workflow sem controle de acesso.

Como funcionam domínios personalizados e white label?

Os limites confirmados são um domínio personalizado no Básico, dez no Starter e trinta no Enterprise. Domínios extras custam R$ 9,99 por mês cada e são limitados à quantidade de instâncias da conta. A tabela resume o teto base por plano:

Plano Domínios personalizados incluídos no limite
Básico 1
Starter 10
Enterprise 30
Domínio adicional R$ 9,99/mês por unidade extra

Para conectar um domínio, o cliente cria um registro CNAME do hostname apontando para cname.<domínio-base> e aplica o hostname pelo painel. O sistema verifica DNS, quota e se o domínio está reservado. Depois, o POD recebe a lista de hosts e configura regras de host e TLS no serviço. O formato de exemplo para acessar a API é https://SEU-DOMINIO/.

Ao estruturar uma operação com várias marcas, mantenha um inventário que associe cada domínio à empresa e ao uso esperado. O modelo permite aplicar vários hosts no mesmo POD, mas a contagem de domínios continua sujeita à quota do plano e ao limite relacionado à quantidade de instâncias. Isso facilita planejar quais endereços devem estar disponíveis em cada etapa da implantação.

No contexto confirmado pela GoZAP, white label significa usar domínio próprio em vez do domínio GoZAP e poder revender o serviço. Vários domínios podem apontar para o mesmo POD, o que permite identificar operações ou marcas por seus endereços. Não há termos contratuais, margens de revenda ou outras condições comerciais publicadas neste guia.

Quando não escolher a GoZAP

Não escolha a GoZAP se sua arquitetura exige hospedar o POD na própria infraestrutura ou se o número de instâncias e domínios necessários excede os limites e as opções confirmadas acima. Se sua política também exige operar exclusivamente pela plataforma oficial da Meta, considere uma alternativa que cumpra esse requisito.

As instâncias podem conectar no modo Web, por QR ou código de pareamento, ou no modo Mobile, com registro pelo número. Ambos ficam fora da API oficial da Meta.