Publicar em um canal
Do agente publicado ao cliente conversando: o widget no seu site (um script), os canais de mensageria (WhatsApp, Telegram, Instagram) e a sua própria aplicação via API.
Atualizado em 01 de set. de 2026
Criar e publicar o agente é metade do caminho — a outra metade é colocá-lo onde o cliente está. Há quatro portas de entrada, e todas desembocam no mesmo agente, com as conversas aparecendo em Threads e as métricas em Estatísticas:
| Canal | Para quem | Esforço |
|---|---|---|
| **Widget no site** | Visitantes do seu site — atendimento, vendas, suporte. | Colar um <script>. Nada de backend. |
| **Mensageria** (WhatsApp, Telegram, Instagram) | Clientes que já conversam por mensagem. | Conectar as credenciais do provedor em Integrações. |
| **Sua aplicação (API)** | Produto próprio, área logada, automações. | [POST /v1/agents/{id}/run](/pt/api/agents/run) com a sua API key. |
| **Outro agente (A2A)** | Interoperar com sistemas de agentes externos. | [Protocolo A2A](/pt/api/agents/a2a), JSON-RPC padrão. |
Na plataforma, abra o agente → Integrações → crie um embed. Ele ganha um identificador público (emb_...) e o snippet pronto:
<script src="https://agents.hinow.ai/embed.js" data-embed="emb_SEU_ID" defer></script>
<!-- opcional: abrir por um botão seu -->
<button onclick="HinowAgent.open()">Falar com o assistente</button>Só isso — o loader cria o botão flutuante (se você pedir), a janela de conversa, o streaming das respostas, upload de anexos e os componentes ricos (formulários, botões) quando o agente os usa.
| Atributo | Efeito |
|---|---|
data-mode | float (janela sobreposta, padrão) ou push (empurra o conteúdo do site para o lado). |
data-width | Largura do painel no desktop, em px (padrão 440). |
data-launcher / data-icon / data-label / data-color | Botão flutuante: presença, ícone (URL de imagem), texto e cor — o contraste do texto é calculado sozinho. |
data-z-index-button / data-z-index-window | Para brigar com o z-index do seu site quando preciso. |
As variáveis do card Início — quem é o usuário, qual o plano, qual a sessão — entram por três caminhos:
<!-- estática: qualquer data-var-* vira variável -->
<script src="https://agents.hinow.ai/embed.js" data-embed="emb_SEU_ID"
data-var-plano="pro" defer></script>
<script>
// dinâmica: depois do login do usuário
HinowAgent.setVariables({ customer_id: usuario.id });
// ou na abertura
HinowAgent.open({ variables: { customer_id: usuario.id } });
</script>É assim que a identidade chega sem senha
O seu site já sabe quem está logado — mande o identificador opaco como variável e o agente consulta a sua API por ele. O desenho completo (e por que nunca se pede senha na conversa) está em Credenciais e identidade.
| Camada | Como funciona |
|---|---|
| Domínios permitidos | Cada embed declara os domínios do site (allowed_domains); fora deles, o widget não abre — reforçado por CSP frame-ancestors no próprio /widget. |
| Sessão curta | O widget troca o emb_... por um token de sessão de curta duração; a API key do dono **nunca** vai ao navegador. |
| Conversas separadas | Threads de canal público vivem em tabela própria, identificadas por visitante — e aparecem normalmente em **Threads** e **Estatísticas** do agente. |
| Anexos | Uploads do widget vão para o storage com limite de 10 MB. |
Em Configurações → Integrações → Mensageria, conecte o provedor com as credenciais dele e associe o agente. As mensagens recebidas viram turnos do agente; as respostas voltam pelo mesmo canal — incluindo mídia.
| Canal | O que você precisa | Capacidades |
|---|---|---|
| **WhatsApp Business** | Access Token + Phone Number ID (WhatsApp Business API da Meta). | Enviar, receber, mídia e templates. |
| **Telegram** | Bot Token (crie com o @BotFather). | Enviar, receber e mídia. |
| **Instagram** | Access Token + Instagram Business ID (Messaging API da Meta). | Enviar, receber e mídia. |
Identificando quem escreve
Em canal aberto ninguém fez login: o identificador é o do canal (telefone, id do chat). Para reconhecer clientes com segurança, use o padrão de vínculo por código de uso único — o fluxo pronto para importar.
O canal mais direto: sua aplicação chama POST /v1/agents/{id}/run com a API key, streaming por SSE, thread_id para continuar a conversa e variables para identificar o usuário. É o caminho de todos os fluxos prontos — e o que os exemplos desta documentação usam.
O caminho completo
Monte no builder, teste no sandbox, publique e escolha o canal.