Conectar o Aircall (telefone na nuvem)

O Aircall é uma central telefônica em nuvem. Ao conectar esse canal, as ligações do seu número Aircall entram no Inbox da Omnifox junto com seus canais de mensagens, deixando todo o histórico com um cliente em um só lugar.

Requisitos

• Uma conta Aircall com um número ativo
• API ID e API Token gerados em dashboard.aircall.io → Integrações → API Keys
• O Number ID do número que vai receber as ligações e o User ID do atendente padrão

Passos para conectar

1. Em dashboard.aircall.io, acesse Integrações → API Keys e gere um API ID + API Token.
2. Identifique o Number ID do seu número Aircall e o User ID do atendente que responde por padrão.
3. Na Omnifox, vá em Canais → Conectar novo canal, escolha Aircall e preencha esses quatro valores.
4. Salve o canal: a Omnifox mostra a Webhook URL (com o ID do canal incluído).
5. No Aircall, crie uma assinatura de webhook apontando para essa URL e copie o Webhook Token fornecido pelo Aircall para o campo Webhook Token na Omnifox.

Configuração

• API ID / API Token: autenticação básica para as chamadas de saída na API do Aircall (dial).
• Number ID: o número Aircall que recebe as ligações.
• User ID: o atendente do Aircall chamado primeiro, antes de bridgear com o destino (padrão "call-back-then-bridge").
• Webhook Token: valida a assinatura Aircall-Signature de cada evento recebido.

Exemplo

Um cliente liga para seu número Aircall; o Aircall primeiro chama o telefone IP do atendente designado e, quando ele atende, faz o bridge da ligação com o cliente. Os eventos do ciclo de vida (criada, tocando, atendida, encerrada) chegam à Omnifox e ficam registrados na conversa desse cliente no Inbox.

Dicas

• O modelo do Aircall é "chama o atendente primeiro, depois faz o bridge": um dial bem-sucedido não conecta a ligação na hora — há uma espera até o atendente responder.
• Se você tem vários números Aircall, conecte cada um como um canal separado com seu próprio Number ID.

Solução de problemas

• As ligações de saída não disparam: confirme que o User ID pertence a um atendente ativo com um telefone IP registrado no Aircall.
• Nenhum evento de ligação chega: verifique se a URL do webhook no Aircall é a mesma gerada pela Omnifox e se o Webhook Token é idêntico nos dois lados.