ChatzoraDocumentação
Desenvolvedores

Opções do código de incorporação

Os atributos que o script do chat do site lê, para desenvolvedores que adicionam o chat manualmente.

Esta página é para desenvolvedores. A maioria das pessoas pode copiar o código de Canais → Chat do site sem alterá-lo. Veja Instalar no seu site.

O código de incorporação

<script
  src="https://chatzora.com/widget.js"
  data-agent-id="YOUR_ASSISTANT_ID"
  data-api-base="https://chatzora.com"
  data-title="Your business name"
  async
></script>

Coloque-o antes da tag de fechamento </body> em todas as páginas em que o chat deve aparecer.

Atributos

AtributoObrigatórioO que faz
data-agent-idSimO assistente a carregar. Sem ele, o script não faz nada.
data-api-baseNãoO endereço da Chatzora com o qual se comunicar. Por padrão, o endereço de onde o script foi carregado.
data-titleNãoTexto do cabeçalho exibido antes de as configurações salvas carregarem.
data-colorNãoCor do tema exibida antes de as configurações salvas carregarem, por exemplo #059669.
data-welcome-messageNãoMensagem de boas-vindas exibida antes de as configurações salvas carregarem.
data-launcher-textNãoTexto do botão do chat exibido antes de as configurações salvas carregarem.
data-positionNãoleft ou right, antes de as configurações salvas carregarem.
data-lead-captureNãotrue para exibir o formulário de contato antes de as configurações salvas carregarem.
data-visitor-idNãoSeu próprio ID estável do visitante, como o ID do seu cliente. Se você o omitir, um ID aleatório é criado e guardado no navegador.

Os atributos de aparência são apenas valores iniciais. Quando o chat carrega, as configurações salvas no painel (Configurações → Janela de chat) os substituem. Altere a aparência no painel, não no código.

Comportamento

  • Em telas de 480 px de largura ou menos, o chat abre em tela cheia. Em telas maiores, abre como uma janela flutuante.
  • As respostas aparecem à medida que são escritas, quando o navegador permite. Respostas que usam uma integração, como uma busca de produtos, chegam de uma só vez.
  • Se Sites autorizados a mostrar o seu chat estiver definido, o chat só funciona exatamente nessas origens.
  • Se o chat do site estiver desativado no painel, o script remove o chat da página.

Content Security Policy

Se o seu site usa uma Content Security Policy, permita script-src, connect-src e frame-src para o endereço da Chatzora (https://chatzora.com). As páginas de agendamento abrem em um frame, então, se você usa links de agendamento, permita também o seu provedor de agenda em frame-src.

Página de chat hospedada

Você pode vincular ou incorporar a página de chat hospedada em vez do script:

https://chatzora.com/widget?agentId=YOUR_ASSISTANT_ID