Para desenvolvedores

Domínios customizados

Publique landing pages e a loja virtual do seu workspace com o domínio da sua marca, mantendo a infraestrutura do Venda no Chat.

A configuração é feita por workspace em Conta → Configurações → Domínios públicos no painel administrativo.

Visão geral

Por padrão, o Venda no Chat publica conteúdos em subdomínios da plataforma:

Texto
Landing pages: {slug}.lp.vendanochat.com.br
Link na Bio:   {slug}.bio.vendanochat.com.br
E-commerce:    {workspace_slug}.sale.vendanochat.com.br

Com domínios customizados, você pode usar a sua própria marca:

  • Landing pages — informe um domínio base (ex.: lp.minhaloja.com.br). Cada landing publicada recebe um subdomínio nesse domínio.
  • Link na Bio — informe um domínio base (ex.: bio.minhaloja.com.br). Cada página publicada recebe um subdomínio nesse domínio.
  • E-commerce — informe o hostname completo da loja (ex.: loja.minhaloja.com.br).

Os campos são opcionais. Se ficarem em branco, continuam valendo os domínios padrão da plataforma.

Configuração no painel

Siga estes passos para cada workspace:

  1. Acesse o painel em Conta → Configurações.
  2. Selecione o workspace desejado no seletor do topo do painel.
  3. Na seção Domínios públicos, preencha os campos de landing, Link na Bio e/ou e-commerce.
  4. Configure os registros DNS conforme as instruções exibidas no formulário.
  5. Clique em Salvar configuração.

A API administrativa correspondente é GET/PATCH /api/workspaces/{workspace_id}/site-config/public-domains/ (requer autenticação e permissão de configuração da conta).

JSON
{
  "landing_custom_base_domain": "lp.minhaloja.com.br",
  "bio_custom_base_domain": "bio.minhaloja.com.br",
  "sale_custom_domain": "loja.minhaloja.com.br",
  "default_landing_base_domain": "lp.vendanochat.com.br",
  "default_sale_base_domain": "sale.vendanochat.com.br",
  "example_landing_host": "minha-promo-meu-workspace.lp.minhaloja.com.br",
  "example_sale_host": "loja.minhaloja.com.br",
  "landing_dns_hint": "CNAME curinga *.lp.minhaloja.com.br → lp.vendanochat.com.br",
  "sale_dns_hint": "CNAME loja.minhaloja.com.br → meu-workspace.sale.vendanochat.com.br"
}

Landing pages

O campo landing_custom_base_domain define o domínio base das suas landing pages publicadas.

Cada landing usa um slug público no formato {nome-da-landing}-{slug-do-workspace}. A URL final fica:

Texto
{scheme}://{slug-publico}.{seu-dominio-base}/

Exemplo com domínio customizado:

Texto
https://black-friday-meu-workspace.lp.minhaloja.com.br/

Exemplo com domínio padrão da plataforma:

Texto
https://minha-promo-meu-workspace.lp.vendanochat.com.br/

O slug público é gerado automaticamente a partir do nome da landing e do slug do workspace. Ele aparece no painel ao publicar a página.

E-commerce

O campo sale_custom_domain recebe o hostname completo da loja — não apenas um subdomínio genérico.

Com domínio customizado:

Texto
https://loja.minhaloja.com.br/

Sem domínio customizado (padrão da plataforma):

Texto
https://meu-workspace.sale.vendanochat.com.br/

Cada hostname de loja customizado é único na plataforma — dois workspaces não podem usar o mesmo domínio de e-commerce.

DNS e CNAME

Após salvar os domínios no painel, configure o DNS no provedor do seu domínio (Registro.br, Cloudflare, Route 53, etc.).

Landing pages

Crie um registro CNAME curinga apontando todos os subdomínios do seu domínio base para a zona de landing da plataforma:

Texto
Tipo:  CNAME
Nome:  *
Valor: lp.vendanochat.com.br

Se o seu provedor não aceitar curinga, crie um CNAME para cada slug público que for utilizar (ex.: black-friday-meu-workspace.lp.minhaloja.com.br).

Link na Bio

Crie um registro CNAME curinga apontando todos os subdomínios do seu domínio base para a zona Link na Bio da plataforma:

Texto
Tipo:  CNAME
Nome:  *
Valor: bio.vendanochat.com.br

E-commerce

Crie um CNAME do hostname da loja para o subdomínio padrão do workspace na plataforma:

Texto
Tipo:  CNAME
Nome:  loja.minhaloja.com.br
Valor: meu-workspace.sale.vendanochat.com.br

Substitua meu-workspace pelo slug real do workspace e loja.minhaloja.com.br pelo domínio que você configurou.

A propagação DNS pode levar de alguns minutos até 48 horas, dependendo do TTL e do provedor.

Exemplos completos

Workspace "acme" com marca própria

JSON
{
  "landing_custom_base_domain": "lp.acme.com.br",
  "sale_custom_domain": "loja.acme.com.br"
}

URLs resultantes:

Texto
Landing: https://promocao-verao-acme.lp.acme.com.br/
Loja:    https://loja.acme.com.br/

Apenas landing customizada

JSON
{
  "landing_custom_base_domain": "pages.minhamarca.com",
  "sale_custom_domain": ""
}

A loja continua em meu-workspace.sale.vendanochat.com.br.

Solução de problemas

  • O domínio não abre a landing/loja — verifique se o CNAME está correto, se a propagação DNS terminou e se o domínio foi salvo no workspace certo.
  • Erro "domínio já em uso" — o hostname de e-commerce é único na plataforma. Escolha outro ou remova a configuração do outro workspace.
  • Certificado HTTPS — em produção, o domínio customizado precisa estar configurado também no proxy/CDN da infraestrutura. Entre em contato com o suporte se o SSL não for provisionado automaticamente.
  • URL ainda mostra domínio da plataforma — confirme que o campo foi salvo e que você está visualizando o workspace correto. Links gerados no painel passam a refletir o domínio customizado após salvar.

Dúvidas sobre integração de dados? Consulte também a documentação da API de terceiros.

Precisa de ajuda?

Consulte a central de ajuda ou fale com o suporte em atendimento.