Integrações

Seus agentes, onde a sua operação acontece

Do script de 1 linha ao multi-agente com identidade e token, oito formas de colocar agentes trabalhando, cada uma com passo a passo e código pronto.

Passo a passo

  1. 1No editor do agente, clique em </> Widget e habilite, a plataforma gera a chave pública (owk_...).
  2. 2Copie o script e cole antes do </body> do seu site (WordPress, Nuxt, React, HTML puro, tanto faz).
  3. 3Pronto. A bolha aparece; cor, título e logo você customiza por atributos ou pela plataforma.

A chave pública identifica só ESTE agente e o que ele pode, é segura para expor no navegador.

O script (gerado pronto na plataforma)

html
<script src="https://studio.weon.com.br/widget/studio-chat.js"
        data-key="owk_SUACHAVE"
        defer></script>

Customização por atributos (opcionais)

html
<script src="https://studio.weon.com.br/widget/studio-chat.js"
        data-key="owk_SUACHAVE"
        data-color="#10b981"
        data-title="Assistente WeON"
        data-subtitle="Resposta em segundos"
        data-logo="https://seusite.com/logo.png"
        data-expanded          <!-- abre em drawer grande -->
        defer></script>

Passo a passo

  1. 1Use data-launcher="custom" no script, a bolha padrão não é injetada.
  2. 2Marque qualquer elemento com data-studio-chat (ou aponte um seletor via data-trigger).
  3. 3Ou controle 100% por JavaScript: StudioChat.open() no evento que quiser.
html
<button data-studio-chat>Falar com o assistente</button>

<script src="https://studio.weon.com.br/widget/studio-chat.js"
        data-key="owk_SUACHAVE"
        data-launcher="custom"
        defer></script>

Ou 100% via JS

js
// no clique de qualquer coisa:
StudioChat.open();     // abre
StudioChat.close();    // fecha
StudioChat.expand();   // abre no modo drawer grande

Passo a passo

  1. 1Estático: atributos data-user-id / data-user-name no próprio script.
  2. 2Pré-boot (SPA): defina window.StudioChatConfig ANTES do script carregar.
  3. 3Dinâmico (após login): chame StudioChat.identify(...) a qualquer momento, inclusive com token Bearer do seu backend.

Com o token, as ferramentas HTTP do agente podem chamar SUAS APIs como o usuário logado, cada chamada sensível passa por aprovação.

Pré-boot (antes do script)

html
<script>
  window.StudioChatConfig = {
    userId: "123",
    userName: "João Silva",
  };
</script>
<script src="https://studio.weon.com.br/widget/studio-chat.js"
        data-key="owk_SUACHAVE" defer></script>

Dinâmico + token do seu sistema (nunca vai em URL, viaja por postMessage)

js
// depois do login no seu app:
StudioChat.identify(
  "123", "João Silva", "gerente",
  "https://app.suaempresa.com",   // baseUrl das suas APIs
  "eyJhbGciOi..."                 // token Bearer (opcional)
);

// só o token, a qualquer momento:
StudioChat.setToken("eyJhbGciOi...");

// logout → volta ao anônimo:
StudioChat.identify(null);

Passo a passo

  1. 1Declare os agentes em StudioChatConfig.agents, cada um com id, key e o botão que o abre.
  2. 2Campos comuns (userId, cor, baseUrl) são herdados da raiz.
  3. 3Abra qualquer um por botão (data-studio-chat="id") ou por JS: StudioChat.open("id").
html
<script>
  window.StudioChatConfig = {
    userId: "123", userName: "João",
    agents: [
      { id: "suporte",      key: "owk_aaa", trigger: "#btn-suporte" },
      { id: "especialista", key: "owk_bbb", trigger: "#btn-esp" },
    ],
  };
</script>
<script src="https://studio.weon.com.br/widget/studio-chat.js" defer></script>

<button id="btn-suporte">Suporte</button>
<button id="btn-esp">Falar com especialista</button>

Passo a passo

  1. 1Use a URL de embed com a chave pública do agente.
  2. 2chrome=0 esconde o header (seu layout manda).
  3. 3Dimensione o iframe como quiser, ele é responsivo.
html
<iframe
  src="https://studio.weon.com.br/embed/chat?key=owk_SUACHAVE&chrome=0"
  style="width:100%;height:640px;border:0;border-radius:16px"
  allow="microphone"
></iframe>

Passo a passo

  1. 1Entrada: em Configurações → Conexões de Entrada, crie a conexão, a plataforma gera URL única + segredo de assinatura.
  2. 2Configure as ações do evento: gravar num painel, alertar o time e/ou invocar o agente com o contexto do evento.
  3. 3Saída/headless: use a API pública para enviar mensagens ao agente da sua própria interface (o chat do nosso site funciona assim).

Assinatura verificada, deduplicação de eventos e trilha de auditoria em toda entrega.

Seu sistema dispara, o agente age

bash
curl -X POST \
  https://studio.weon.com.br/api/v1/webhooks/inbound/SEU_TENANT/lead-site \
  -H "Content-Type: application/json" \
  -H "X-Signature: sha256=..." \
  -d '{"nome":"Maria","email":"maria@x.com","origem":"landing-page"}'

Passo a passo

  1. 1Instale a extensão WeON Studio no Chrome (link no editor do agente).
  2. 2Logado na plataforma, ela conecta sozinha.
  3. 3Defina os sites permitidos por agente, fora da lista, bloqueado por padrão.

Passo a passo

  1. 1Convide o time em Configurações → Usuários.
  2. 2Cada pessoa escolhe o agente e conversa, a lâmpada 💡 mostra o que ele sabe fazer.
  3. 3Ações sensíveis pedem aprovação; tudo fica auditável na Governança.
Por dentro

Simples por fora, governado por dentro

Chave pública por agente

Cada agente exposto tem uma owk_... própria: identifica só ele, com o escopo dele. Revogou, morreu, sem afetar o resto.

Nada sensível no navegador

Token do seu sistema viaja por postMessage (nunca em URL), rate-limit por visitante, escopo de tópicos e aprovação humana nas ações de escrita.

Tudo auditável

Cada conversa do widget, cada webhook recebido e cada ação executada aparecem na Governança, com custo, trace e origem.

Guia prático

Do zero a um SDR atendendo no seu site

O caminho completo, o mesmo vale para suporte, agendamento ou qualquer agente voltado ao público.

1

Crie o agente na galeria

Em Agentes → Criar novo agente, escolha um perfil comercial. Ele nasce configurado; o No Brain Mode adapta à sua operação: seu ICP, seu tom, suas perguntas de qualificação.

2

Dê conhecimento e regras

Suba seu material (site, catálogo, tabela de preços) numa Base de Conhecimento e defina o escopo: o que responde, o que recusa, para onde redireciona.

3

Ligue o widget no site

No editor do agente → </> Widget → habilitar → cole o script no site. O agente passa a receber visitantes.

4

Identifique e conecte ao seu fluxo

Se o visitante logar, identifique-o (identify). Lead qualificado cai onde você quiser: CRM via API, alerta no Slack, painel vivo, ou outro agente assume o follow-up.

5

Acompanhe e melhore

Na Governança: cada conversa, custo, notas de qualidade e propostas de melhoria. Ajuste conversando com o No Brain Mode.

Dúvidas frequentes

FAQ de integração

Sim. A chave pública (owk_...) identifica apenas um agente específico e o escopo dele, não dá acesso à sua conta, aos seus dados nem a outros agentes. Tokens sensíveis nunca vão em URL: viajam por postMessage, só entre a sua página e o iframe.

Em qualquer site que aceite uma tag <script>. Para SPAs, o widget acompanha a navegação e você pode identificar o usuário dinamicamente após o login com StudioChat.identify().

Não. O widget atende anônimos por padrão. Se o seu sistema já sabe quem é o usuário, você informa via identify() e o agente passa a tratá-lo pelo nome, com histórico.

Do jeito que você preferir: o agente pode gravar num painel (Live App), disparar alerta no Slack/e-mail, ou chamar sua API/CRM via ferramenta HTTP, com aprovação humana se a ação for sensível.

Sim: cor, título, subtítulo, logo e comportamento (bolha, botão próprio ou drawer expandido), por atributos no script ou pela plataforma, sem código adicional.

Cada agente tem sua chave; você pode usar o mesmo agente em vários sites ou agentes diferentes por produto, inclusive vários agentes na mesma página com um único script (StudioChatConfig.agents).

Consome créditos do seu plano como qualquer conversa, com rate-limit por visitante para proteger seu orçamento, e todo o consumo visível em Governança → Uso & Custos.

Comece pelo caminho mais curto

Contamos o que já conectamos e o que dá pra plugar na sua operação, do webhook do seu sistema ao agente atendendo no seu site.

Os agentes chegam até você como módulos da WeON: implantados, calibrados e governados pelo nosso time