For the complete documentation index, see llms.txt. This page is also available as Markdown.

Configurações da Plataforma

Configure os recursos, o suporte, os valores dos apps, a autenticação e a identidade visual do seu ambiente: logotipos, cores, menu e tela de acesso.

A tela Configurações da plataforma substitui a antiga tela Personalizar. As configurações agora ficam organizadas em seções no menu lateral, e cada seção é salva de forma independente.

Acesse as Configurações da plataforma

No menu superior, clique em Admin e selecione Configurações da plataforma. O item aparece com a etiqueta NOVO ao lado do nome.

A tela abre com o menu lateral à esquerda. Ao clicar em uma seção, o conteúdo à direita é substituído sem recarregar a página.

Dados cadastrais

Exibe as informações cadastrais da sua empresa: Dados da empresa (nome fantasia, razão social, CNPJ e e-mail de contato), Endereço e Administrador. Os campos são apenas para consulta e não podem ser editados nesta tela.

O E-mail de contato é o endereço exibido nos seus termos de uso e política de privacidade.

Configurações

Informações da empresa

  • Nome da empresa (obrigatório): nome exibido nas diferentes áreas da plataforma. Aceita até 50 caracteres. Enquanto o campo estiver vazio, o botão Salvar fica desabilitado e a mensagem "Insira o nome da empresa" é exibida.

  • E-mail para comunicações: recebe as comunicações do sistema, incluindo o aviso de criação de um novo ambiente de teste. Para informar mais de um endereço, separe-os com ponto e vírgula (;).

Recursos

Define quais canais e funcionalidades ficam disponíveis na plataforma:

  • Permitir demonstração: habilita o botão "Crie uma conta e teste gratuitamente" na tela de login do seu ambiente, permitindo que interessados criem contas de teste.

  • Ativar canal não oficial (integrado): habilita o uso de canais não oficiais (via QR Code) gerenciados diretamente pela plataforma.

  • Ativar canal não oficial (conta própria): permite que o cliente conecte o próprio número de WhatsApp não oficial (via QR Code) utilizando a própria instância.

Pelo menos uma das opções de canal não oficial precisa estar marcada para que a funcionalidade Canal não oficial fique disponível no plano da conta.

Suporte

Define para onde seus clientes são direcionados quando precisam de ajuda.

  • Número de contato: usado para gerar o link do botão de ação nos avisos de bloqueio e suspensão, para que o cliente fale com a sua equipe e regularize a situação.

  • Link de suporte: URL completa (com https://) aberta quando o usuário clica em Preciso de ajuda, no menu de usuário ou no ícone de interrogação no canto superior direito. Pode ser uma central de ajuda própria, um link de WhatsApp (ex.: https://wa.me/5599999999999?text=Ajuda) ou um formulário de chamados.

Os avisos que usam o número de contato podem ser ajustados em Gestão e Edição de Avisos Padrão do Sistema.

Apps

No card Precificação, informe o valor mensal que você cobra do cliente por cada aplicativo adicional. O valor configurado aparece no card do aplicativo, na tela de Apps do cliente, deixando claro o custo antes da ativação.

  • Todos os campos usam o formato R$ 0,00 e não são obrigatórios.

  • Se um app faz parte do seu pacote padrão, deixe o valor zerado.

  • Na Pesquisa CSAT, escolha o modo de cobrança antes de informar o valor: Valor fixo ou Por usuário.

Integração

É possível ter até 5 tokens cadastrados. Ao atingir o limite, o botão Criar token fica desabilitado.

O card Tokens de Parceiro gerencia as credenciais usadas para integrar a plataforma com sistemas externos. Cada token acessa as APIs da plataforma com as permissões de parceiro, incluindo os endpoints de Contas e Parceiros.

Para criar um token:

  1. Clique em Criar token.

  2. Informe um Nome para identificá-lo depois.

  3. Clique em Salvar.

O token aparece na tabela com o nome, o valor mascarado (pn_****...****) e a data de criação. Clique no ícone de copiar para levar o valor completo ao seu sistema. Nas requisições, envie o token no header Authorization com o esquema Bearer.

No menu de três pontos da coluna Ações, você pode Editar o nome do token ou Excluí-lo.

Autenticação

Define por qual canal a plataforma envia o código de verificação (OTP). O canal configurado aqui vale para qualquer ação da plataforma que exija esse código. O login pelo número de telefone, o disparo de campanhas e a exclusão de canais são apenas alguns exemplos.

Escolha o modelo de envio

  • Padrão da plataforma (selecionado por padrão): o código é enviado pelo canal padrão da plataforma, o wts.chat, sem precisar selecionar um canal nem ter uma conta associada.

  • Canal próprio: o código é enviado por um canal de WhatsApp da conta associada ao seu ambiente de parceiro.

Para usar o Canal próprio, é necessário ter uma conta associada com pelo menos um canal de WhatsApp. Caso contrário, a tela exibe um aviso e o botão Salvar fica desabilitado:

  • Conta não associada: solicite a associação de uma conta pelo botão Suporte exibido no aviso.

  • Nenhum canal WhatsApp na conta associada: conecte ao menos um canal de WhatsApp nessa conta.

Configure o canal próprio

  1. Em Selecione o canal para envio do OTP, escolha um dos canais de WhatsApp da conta associada. Canais da API Oficial e canais não oficiais são listados.

  2. Em Mensagem do OTP, defina o modelo de mensagem do tipo Autenticação que será enviado:

    • Se o canal ainda não tem nenhum modelo de Autenticação, clique em Criar modelo. O modelo "Código OTP" é criado automaticamente e passa a aparecer também na tela de Modelos de Mensagem.

    • Se o canal tem apenas um modelo disponível, ele é selecionado automaticamente.

    • Se o canal tem mais de um modelo, clique em Selecionar modelo e escolha na lista, que mostra o status de cada um.

Com o modelo definido, o campo exibe o nome, o status e a pré-visualização da mensagem. Para trocar de modelo, clique no ícone de lixeira e selecione outro.

Ao trocar o canal selecionado, o campo Mensagem do OTP volta ao estado inicial e o modelo precisa ser definido de novo.

Para entender as categorias de modelo e o processo de aprovação, consulte Tipos de modelo de mensagem.

Defina a alternativa em caso de falha

Escolha o que acontece quando o canal próprio ou o modelo não estiver disponível no momento do envio:

  • Usar o canal padrão como alternativa (wts.chat) (selecionado por padrão): o código é enviado automaticamente pelo canal padrão da plataforma.

  • Usar SMS como alternativa: o código é enviado automaticamente por SMS.

Salve a configuração

Clique em Salvar. Por segurança, a plataforma solicita um código de verificação antes de aplicar a alteração. Se o código for inválido, uma mensagem de erro é exibida e você pode tentar novamente.

A partir daí, todo código de verificação solicitado na plataforma passa a ser enviado pelo canal configurado, com o mesmo tempo de expiração do canal padrão.

Aparência

Reúne a identidade visual da plataforma em quatro abas: Logotipos, Cores, Menu e Tela de acesso.

Você pode alternar entre as abas sem perder o que alterou: as mudanças ficam guardadas até você salvar ou descartar. A cor escolhida em Cores já aparece nas pré-visualizações das outras abas, mesmo antes de salvar.

Logotipos

Envie os logotipos e ícones da sua marca para que seus clientes vejam a sua identidade visual em cada ponto da plataforma. Você pode gerar as variações automaticamente a partir de uma única logo ou enviar cada arquivo manualmente.

Gerar variações com IA

  1. Em Logo de referência, clique em Anexar imagem e selecione um arquivo PNG, JPG ou SVG.

  2. Clique em Gerar variações. A plataforma cria quatro versões: Horizontal Claro, Horizontal Escuro, Quadrada Claro e Quadrada Escuro.

  3. Se não gostar do resultado, clique em Gerar novamente para criar novas versões.

  4. Clique em Aplicar logos. As variações preenchem os campos correspondentes no modo Completo.

No primeiro acesso, quando ainda não há logos configuradas, a aba exibe apenas a seção Logo de referência. Depois que as logos estão configuradas, a geração fica disponível no banner Gere variações da sua logo, no topo da aba.

Enviar os logotipos manualmente

Em Escolha como enviar os logotipos, selecione um dos modos:

  • Simplificado: você envia duas logos e a plataforma as distribui por todos os pontos de uso.

  • Completo: você envia uma logo específica para cada ponto de uso.

Modo
Logo
Onde aparece
Formato recomendado
Versões

Simplificado

Menu - Retangular

Áreas horizontais, como menu superior e tela de carregamento

PNG ou JPG, 120×40 px

Claro e Escuro

Simplificado

Menu - Quadrada

Áreas compactas, como menus recolhidos e aba do navegador

PNG ou JPG, 32×32 px

Claro e Escuro

Completo

Menu - Retangular

Menu superior e menus laterais expandidos

PNG ou JPG, 120×40 px

Claro e Escuro

Completo

Menu - Quadrada

Menus laterais recolhidos

PNG ou JPG, 32×32 px

Claro e Escuro

Completo

Tela de acesso

Tela de login e cadastro

PNG ou JPG, 168×56 px

Claro

Completo

Carregamento

Tela de carregamento ao abrir a plataforma

PNG ou JPG, 168×56 px

Escuro

Completo

Navegador

Aba do navegador e favoritos

SVG, PNG ou JPG, 24×24 px

Claro

Completo

Notificação

Notificações do sistema operacional

PNG ou JPG, 32×32 px

Claro

Completo

E-mail

Cabeçalho dos e-mails automáticos, como o do código de acesso

PNG ou JPG, 120×40 px

Claro

Para cada campo, clique em Anexar imagem. Depois do envio, use os ícones ao lado do arquivo para Alterar imagem, Baixar ou Excluir imagem. Abaixo dos campos, a pré-visualização mostra como a logo fica aplicada.

No menu de subabas, o ícone ao lado de cada nome indica se ela já tem imagem configurada (✓) ou não (⊖).

Se você editou alguma logo manualmente no modo Completo depois de aplicar as variações geradas por IA e voltar para o modo Simplificado, a plataforma pede confirmação ao salvar. Ao confirmar, as logos individuais são descartadas e os campos voltam a usar as versões geradas por IA.

Cores

Define a cor de destaque da plataforma, usada em botões, links, ícones e demais elementos de interface.

  1. Em Escolha uma cor, selecione uma das 21 cores da paleta.

  2. Em Escolha uma tonalidade, selecione Claro, Médio ou Escuro.

A tonalidade Médio está disponível apenas para as cores Azul ardósia, Azul royal, Azul índigo, Violeta, Roxo, Roxo escuro, Púrpura, Rosa, Rosa escuro e Vermelho. Se a tonalidade Médio estiver selecionada e você escolher uma cor sem essa opção, ela muda automaticamente para Claro.

A pré-visualização mostra, lado a lado, a tela de Atendimentos e um painel de Botões e textos com a cor aplicada. Os checkboxes, botões de opção e chaves desse painel podem ser clicados para ver a cor em cada estado.

Para voltar à cor original da plataforma, clique em Selecionar cor padrão, ao lado do título Escolha uma cor.

A cor escolhida aqui também define o tema Cor tema do menu e a tonalidade dos planos de fundo coloridos da tela de acesso.

Escolha o layout do menu:

  • Moderno: barra horizontal no topo, com o logotipo e os itens de menu em linha.

  • Fino: barra lateral apenas com ícones, que se expande ao clicar em um ícone.

  • Clássico: barra lateral com o logotipo no topo e os itens listados com ícone e nome.

  • Denso: barra lateral apenas com ícones, que se expande ao passar o mouse.

Escolha o tema do menu:

  • Claro: fundo branco com itens em tom escuro.

  • Escuro: fundo escuro com itens em tom claro.

  • Cor tema: fundo na cor definida na aba Cores, com itens em tom claro.

As miniaturas dos layouts são atualizadas na hora ao trocar o tema. Os menus criados em Menus personalizados aparecem em todos os layouts.

Tela de acesso

Define a aparência da tela de login exibida para os seus usuários, no computador e no navegador do celular. No primeiro acesso, a aba já vem com o layout Tela dividida, textos de boas-vindas preenchidos, cor Branco e plano de fundo Padrão.

Escolha o layout:

  • Clássico: sem painel lateral. Não exibe textos nem plano de fundo, apenas o logotipo.

  • Moderno, Tela dividida, Tela cheia e Flutuante: layouts com painel lateral, que exibem textos e plano de fundo.

Nos layouts com painel lateral, ative Alternar disposição para inverter a posição do formulário e do painel.

Textos

  • Título de destaque: até 100 caracteres, exibido ao lado do formulário de acesso.

  • Descrição: até 300 caracteres, exibida abaixo do título.

  • Cor do título e descrição: Preto ou Branco.

Deixe um campo em branco para ocultá-lo na tela de acesso.

Confira se a cor dos textos tem bom contraste com o plano de fundo escolhido. Texto branco sobre fundo claro, por exemplo, fica difícil de ler.

Plano de fundo

Escolha uma das opções prontas (Padrão, Anéis, Grade, Linhas, Pontos, Xadrez, Mosaico ou Gradiente) ou envie seu próprio arquivo em Ou envie seu próprio arquivo:

  • Formatos: PNG, JPG ou GIF, com até 10 MB.

  • Tamanho mínimo: 1920×1080 pixels.

Ao enviar um arquivo, a opção Personalizado é criada e selecionada automaticamente. GIFs são reproduzidos em repetição contínua. Se você excluir o arquivo, a opção Personalizado some e o plano de fundo anterior volta a ser usado.

Logotipo

Envie o logotipo exibido acima do formulário de acesso. Essa imagem é a mesma da logo Tela de acesso da aba Logotipos: alterar em um lugar atualiza o outro. Se a aba Logotipos estiver no modo Simplificado, alterar a imagem por aqui muda automaticamente para o modo Completo, para que a tela de acesso tenha uma logo exclusiva.

Pré-visualização

A pré-visualização reflete na hora o layout, a disposição, os textos, a cor, o plano de fundo e o logotipo. Clique em Visualizar em tela cheia para ver o resultado no tamanho real.

Salvar e descartar alterações

Cada seção tem os botões Cancelar e Salvar ao final. Nas seções Configurações e Autenticação, o botão Salvar só é habilitado quando os campos obrigatórios estão preenchidos.

Nas seções Configurações, Apps, Integração e Autenticação, cada seção é salva separadamente: o botão Salvar grava apenas o que foi alterado na seção aberta.

Ao salvar na Aparência, a plataforma pede confirmação:

  • Se você alterou apenas uma aba, confirme em Salvar.

  • Se alterou duas ou mais abas da Aparência (Logotipos, Cores, Menu ou Tela de acesso), a janela oferece duas opções:

    • Salvar apenas a aba em que você está (por exemplo, Salvar apenas Menu). As alterações das outras abas não são salvas, mas continuam na tela para você salvar ou descartar depois.

    • Salvar todas as alterações (selecionada por padrão). A janela indica quais abas tiveram alteração, como "Cores e Menu".

    Escolha uma opção e clique em Confirmar.

Após salvar, a mensagem "Suas alterações foram salvas." é exibida por alguns segundos.

Ao cancelar ou sair com alterações pendentes, a plataforma exibe o aviso Alterações não salvas:

  • Voltar: fecha o aviso e mantém as alterações.

  • Sim, descartar alterações: descarta as alterações e, se você estava saindo da seção, segue para o destino escolhido.

Ao recarregar a página com alterações pendentes, o próprio navegador pede confirmação antes de sair.

Confira o resultado

Depois de salvar, verifique se a personalização foi aplicada como esperado:

  • Logotipos, cores e menu: navegue pela plataforma e confira o menu, os botões e a aba do navegador.

  • Tela de acesso: abra o endereço do seu ambiente em uma janela anônima do navegador, ou saia da conta, para ver a tela de login.

  • Autenticação: faça uma ação que exija código de verificação, como o login pelo número de telefone, e confira se o código chegou pelo canal configurado.

Toda alteração salva gera um registro no Histórico de Alterações, em Admin → Auditoria, com o valor anterior e o novo de cada item alterado.

Considerações Adicionais:

  • A personalização vale para o ambiente do parceiro como um todo. Não é possível definir logotipos, cores ou tela de acesso diferentes para cada conta.

  • Para que a plataforma responda no endereço da sua marca, configure também o Domínio Personalizado.

Atualizado