Conectar o Aircall (telefone na nuvem)
Conecte seu número do Aircall à Omnifox para fazer e receber ligações direto do Inbox.
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
- Em dashboard.aircall.io, acesse Integrações → API Keys e gere um API ID + API Token.
- Identifique o Number ID do seu número Aircall e o User ID do atendente que responde por padrão.
- Na Omnifox, vá em Canais → Conectar novo canal, escolha Aircall e preencha esses quatro valores.
- Salve o canal: a Omnifox mostra a Webhook URL (com o ID do canal incluído).
- 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-Signaturede 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.
Artigos relacionados
-
Códigos de erro do WhatsApp (Meta): o que significam e o que fazer
Tabela com os códigos de erro da Meta mais comuns ao enviar pelo WhatsApp (131026, 131047, 131049, 130497, 141006, 131031, 131056, 132000, 190, 368…) e como resolver cada um.
-
Como conectar o Telegram
Conecte um bot do Telegram à sua caixa de entrada do Omnifox em minutos usando o BotFather.
-
Comentários do Instagram e do Facebook: responder e moderar pelo Omnifox
Veja e responda os comentários das suas publicações e anúncios do Facebook e do Instagram, em público ou no privado, e configure respostas automáticas.
-
Enviar e receber vídeos em cada canal: formatos e tamanhos máximos
Quais vídeos você pode enviar e receber pelo WhatsApp, Instagram, Messenger, Telegram, chat do site e e-mail, com os tamanhos máximos reais e o que fazer com um vídeo pesado.
-
Conectar o WhatsApp escaneando um código QR
Vincule seu WhatsApp ao Omnifox em um minuto, como no WhatsApp Web. Ideal para testar: tem limites, não permite campanhas e não é a API oficial.