> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pilotstatus.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Chatwoot

> Conecte qualquer número de WhatsApp ao Chatwoot com três credenciais — o Pilot Status cria automaticamente a inbox e o webhook e mantém as conversas em sincronia bidirecional.

O Pilot Status possui uma integração nativa com o Chatwoot: conecte qualquer número de WhatsApp a uma conta Chatwoot e as conversas sincronizam **bidirecionalmente** — mensagens recebidas do WhatsApp aparecem no Chatwoot, e as respostas dos agentes no Chatwoot são entregues no WhatsApp.

<Frame caption="A página do Chatwoot — status da conexão, alternância de espelhamento, IDs de inbox/conta, reconectar e atualização de credenciais.">
  <img src="https://mintcdn.com/iaxp/cXfei3Cqo3XeJzDh/images/dashboard/chatwoot.png?fit=max&auto=format&n=cXfei3Cqo3XeJzDh&q=85&s=58a63071cbc73b5d23a6cc46b9fd6527" alt="Página do Chatwoot do Pilot Status" width="1920" height="896" data-path="images/dashboard/chatwoot.png" />
</Frame>

## Pré-requisito: `FRONTEND_URL` (Chatwoot self-hosted)

Se você executa um Chatwoot **self-hosted**, a variável de ambiente `FRONTEND_URL` **deve** estar configurada antes de conectar:

```env theme={null}
FRONTEND_URL=https://chatwoot.your-domain.com
```

* Use a URL **pública** exata (mesmo esquema/host do navegador), **sem barra no final**, acessível pela internet — nunca `localhost` nem um IP interno.
* Reinicie **ambos** os containers web e sidekiq depois (o Rails deriva `default_url_options[:host]` a partir dela na inicialização).

<Warning>
  Sem `FRONTEND_URL`, o Chatwoot não consegue construir URLs absolutas de anexos nem webhooks de saída válidos. Sintomas no Pilot Status: mensagens marcadas como **"Falha ao enviar"**, mídia nunca entregue, e `ArgumentError: Missing host to link to!` nos logs do Chatwoot/sidekiq.
</Warning>

Para validar: envie uma mensagem com um anexo em uma conversa de teste — nenhum `Missing host to link to!` nos logs, a mensagem aparece como enviada no Pilot Status, e a mídia chega no WhatsApp.

## Configurar a integração

A integração é configurada **por número** na página **Chatwoot** do painel do Pilot Status.

<Steps>
  <Step title="Reúna três credenciais do Chatwoot">
    * **Instance URL** — a URL base do seu Chatwoot (ex.: `https://chatwoot.your-domain.com` ou `https://app.chatwoot.com`).
    * **Account ID** — o número na URL do seu Chatwoot após `/app/accounts/`.
    * **User Access Token** — nas configurações de perfil do seu Chatwoot.
  </Step>

  <Step title="Conecte no Pilot Status">
    Abra a página **Chatwoot** no painel, selecione o número de WhatsApp e cole os três valores. O Pilot Status **cria automaticamente uma inbox de API e o webhook** na sua conta Chatwoot — você nunca cola uma URL de webhook manualmente.
  </Step>

  <Step title="Converse">
    Mensagens recebidas do WhatsApp (incluindo mídia) abrem conversas na nova inbox; as respostas dos agentes voltam para o WhatsApp. O histórico de mensagens e o status de entrega permanecem sincronizados.
  </Step>
</Steps>

## Pausar ou desconectar

Na mesma página do Chatwoot você pode **pausar** a sincronização por número (um botão de alternância — nada é excluído; ative-o novamente para retomar) ou **desconectar** a integração por completo.

## Chamadas de voz

As chamadas de voz e a inbox do Chatwoot são **superfícies separadas** — os eventos de chamada do WhatsApp **não** são publicados nas conversas do Chatwoot. Há duas formas de trabalhar com chamadas:

1. **Atender chamadas no painel do Pilot Status** (pronto para uso, sem configuração): a página **/chat** do painel tem um softphone integrado que atende e faz chamadas de voz do WhatsApp para **ambos** os tipos de conexão — números da **API Meta oficial (Meta Cloud API)** via WebRTC e números **não oficiais (Pilot Status web)** por meio de uma sessão de áudio no servidor. Veja [Visão geral de Chamadas](/pt-BR/api/calls/overview).
2. **Usar o canal de voz nativo do próprio Chatwoot** (avançado, self-hosted): o Chatwoot **v4.15+** traz um canal de voz nativo; você pode roteá-lo através do Pilot Status **apenas** para números da **API Meta Cloud** — em um Chatwoot self-hosted, aponte a URL base do WhatsApp Cloud para a camada Meta do Pilot Status (`/api/layer/meta`), crie uma inbox manual do WhatsApp Cloud para o número e adicione um webhook do Pilot Status com escopo naquele número, com o evento `calls`, apontando para o webhook da inbox do Chatwoot. O Chatwoot Cloud (`app.chatwoot.com`) e os números não oficiais **não** são suportados nesse caminho.

## Relacionados

* [Painel de Chat ao Vivo](/pt-BR/dashboard/live-chat)
* [Retenção de Dados e Modos de PII](/pt-BR/trust/data-retention) — o relay do Chatwoot continua funcionando mesmo no modo `RELAY_ONLY`.