Conectar o RingCentral (telefone na nuvem)

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

1. Em developers.ringcentral.com, crie um app do tipo REST API com autenticação OAuth Authorization Code.
2. Na Omnifox, vá em Canais → Conectar novo canal, escolha RingCentral e cole o Client ID e o Client Secret do seu app.
3. Escolha o ambiente: Production (platform.ringcentral.com) ou Sandbox (platform.devtest.ringcentral.com), conforme o caso.
4. A Omnifox mostra um Redirect URI: copie-o e registre-o nas configurações OAuth do seu app no RingCentral.
5. 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.