Conectando um app

A página Integrações conecta a Ringhum às ferramentas que sua equipe já usa. Depois que um app é conectado, a Ringhum envia a ele chamadas, mensagens, agendamentos e pedidos conforme acontecem. Alguns apps também retornam informações, como horários ocupados de um calendário ou os pedidos de um cliente na sua loja. Você conecta cada app uma vez para todo o workspace, e todo assistente no workspace o utiliza.

Antes de começar

• Somente o Proprietário e os Admins do workspace podem conectar, alterar ou desconectar apps. Membros e Visualizadores podem ver a página, e os cards mostram Peça a um admin para conectar este app.
• A maioria dos apps está disponível em todos os planos. O Google Calendar (sincronização bidirecional) e o Calendly fazem parte dos planos Team e Scale. Em outros planos, seus cards mostram um cadeado de plano em vez de Conectar.
• Você precisa de uma conta no outro app, e geralmente de direitos de admin nele para criar uma chave de API ou um webhook.

O catálogo de apps

Abra Integrações na barra lateral. Use a caixa de busca ou os botões de categoria para encontrar um app. O botão Conectado mostra apenas os apps que você já conectou.

Se sua ferramenta não estiver listada, geralmente você pode alcançá-la pelo Zapier, Make ou n8n, ou com seu próprio endpoint de webhook em Desenvolvedores. O botão Webhooks e API no topo da página leva você até lá.

Três formas de conectar

Cada app usa um de três tipos de conexão. O card e a caixa de diálogo de conexão mostram qual é.

Dois grupos funcionam de forma diferente. O card Feed de calendário (ICS) fornece um link para você colar no seu app de calendário; você não conecta nada. Os canais de hotéis (Booking.com, Airbnb, Vrbo) são configurados por quarto: seus cards têm um botão Configurar em Quartos que abre Quartos e tarifas.

Conecte um app com uma chave ou uma URL de webhook

1. Abra Integrações e encontre o app.
2. Clique em Conectar no card dele. A caixa de diálogo Conectar se abre com uma breve descrição de onde encontrar as credenciais no outro app. Muitos apps também têm um link de Documentação.
3. Preencha os campos, por exemplo uma chave de API, um subdomínio, um id de lista ou projeto, ou uma URL de webhook.
4. Em Enviar, marque os eventos que o app deve receber. Veja Escolhendo o que é enviado.
5. Se a caixa de diálogo mostrar a opção Somente chamadas que requerem atenção, decida se o app deve ficar sabendo de toda chamada ou só das que precisam que alguém aja.
6. Clique em Conectar.

A Ringhum verifica a conexão antes de salvar qualquer coisa. Se a verificação falhar, nada é salvo e a caixa de diálogo mostra Não foi possível conectar com o motivo informado pelo outro app, como uma chave recusada. Corrija o campo e tente novamente.

Nota: As credenciais são armazenadas de forma criptografada e usadas apenas pelos nossos servidores.

Conecte um app fazendo login

1. Clique em Conectar no card. Você é levado ao outro serviço.
2. Faça login e aprove o acesso solicitado.
3. Você volta para Integrações com uma mensagem de confirmação.

Alguns apps de login precisam de mais um passo. Para o Google Sheets, clique em Configurações no card e cole o id da planilha. Até você fazer isso, as entregas são ignoradas com a mensagem "Adicione o id da planilha nas configurações da integração". O Google Drive funciona imediatamente e salva arquivos em Meu Drive, a menos que você adicione um id de pasta em Configurações.

Teste a conexão

Um card conectado mostra um selo de status: Conectado, Erro ou Pausado. Também mostra o horário da última entrega e os eventos que o app recebe.

• Enviar teste (apps de mensagens e automação) publica uma mensagem de teste, para você ver ela chegar no canal ou fluxo de trabalho.
• Testar (todos os outros apps) verifica se as credenciais ainda funcionam.

O resultado aparece como uma mensagem no topo da tela. Para Zapier e Make, envie um evento de teste antes de mapear campos, para que o fluxo de trabalho aprenda a estrutura dos dados.

Gerencie uma conexão

Um card conectado tem alguns ou todos estes botões:

• Configurações (apps com campos a preencher) reabre a caixa de diálogo para alterar credenciais ou eventos. Clique em Salvar configurações. A conexão é verificada novamente antes de a alteração ser salva.
• Reconectar (apps de login) repete o login, por exemplo depois que você muda sua senha ou o acesso expira.
• Pausar interrompe todas as entregas sem perder as configurações. Retomar as reinicia.
• Desconectar remove a conexão e suas credenciais armazenadas.

Solução de problemas

O botão Conectar não aparece. Você pode não ser Proprietário ou Admin, o app pode precisar de um plano superior (o card mostra um cadeado de plano), ou um app de login pode mostrar Requer configuração, o que significa que ele não está disponível no momento. Entre em contato com o suporte se esse selo persistir.

Um banner diz "Conectores nativos estão desativados para este espaço de trabalho". Apps de CRM, central de ajuda, tarefas, planilhas, marketing, análise de dados e e-commerce estão desativados para o seu workspace. Apps de mensagens, automação e calendário continuam funcionando. Entre em contato com o suporte para reativá-los.

Minha chamada de teste não apareceu no Slack ou no meu CRM. Atualizações de chamadas, itens da caixa de entrada e pedidos de chamadas de teste não são enviados a apps conectados. Faça uma chamada real para o número.

O card mostra Erro. Clique na linha da última entrega no card para ver o que deu errado. Veja Solução de problemas de entregas.