Conectar o RingCentral (telefone na nuvem)
Conecte seu próprio app do RingCentral à Omnifox (modelo BYO) para gerenciar ligações direto do Inbox.
O RingCentral se conecta usando um modelo "traga seu próprio app" (BYO): em vez de a Omnifox usar um app compartilhado, cada cliente registra sua própria aplicação no RingCentral e informa à Omnifox o Client ID e o Client Secret desse app.
Requisitos
- Uma conta RingCentral (production ou sandbox)
- Um app registrado em developers.ringcentral.com, do tipo REST API, com autenticação OAuth Authorization Code
- O Client ID e o Client Secret desse app
Passos para conectar
- Em developers.ringcentral.com, crie um app do tipo REST API com autenticação OAuth Authorization Code.
- Na Omnifox, vá em Canais → Conectar novo canal, escolha RingCentral e cole o Client ID e o Client Secret do seu app.
- Escolha o ambiente: Production (platform.ringcentral.com) ou Sandbox (platform.devtest.ringcentral.com), conforme o caso.
- A Omnifox mostra um Redirect URI: copie-o e registre-o nas configurações OAuth do seu app no RingCentral.
- Clique em Conectar com RingCentral — você será redirecionado para fazer login e autorizar o acesso; ao voltar, o canal fica ativo.
Configuração
- Client ID / Client Secret: credenciais do SEU app do RingCentral (não são compartilhadas pela Omnifox).
- Server: Production ou Sandbox — precisa corresponder a onde sua conta real está.
- Os tokens de acesso duram cerca de 1 hora e o refresh token gira a cada ~7 dias; a Omnifox os renova automaticamente.
Exemplo
Um cliente liga para seu número RingCentral; o sistema executa um RingOut que primeiro chama o dispositivo registrado do atendente e, quando ele responde, faz o bridge da ligação com o número do cliente. O evento aparece no Inbox como parte dessa conversa.
Dicas
- Se estiver testando a integração, use o Sandbox primeiro — assim você não arrisca sua linha de produção enquanto valida o fluxo.
- Guarde bem o Client Secret: o RingCentral só o exibe uma vez, no momento em que o app é criado.
Solução de problemas
- A autorização falha com "redirect_uri mismatch": confirme que o Redirect URI registrado no RingCentral é exatamente igual ao mostrado pela Omnifox, sem barra final a mais ou a menos.
- O canal para de receber eventos depois de alguns dias: o refresh token pode não ter rotacionado com sucesso; reconecte o canal para reautorizar do zero.
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.