Integrações
A aba onde a OctoSolve conversa com outros sistemas. Chaves de API para um programa ler seus dados, webhooks para avisar seu sistema quando algo acontece, e o servidor MCP para você comandar sua conta conversando com uma IA.
Integrações 🔌
Esta aba serve para uma coisa só: deixar outro sistema conversar com a sua conta da OctoSolve. Pode ser o site da sua clínica, uma planilha, um robô de automação, ou uma inteligência artificial como o Claude.
Você não precisa dela para o agente atender no WhatsApp. Isso já funciona sozinho. Integrações é para quando você quer ir além.
Integrações está disponível nos planos Plus e Pro. No Starter a aba aparece, mas mostra o convite para trocar de plano.
As três coisas que moram aqui
Elas parecem parecidas e não são. A diferença é quem começa a conversa.
| O quê | Quem começa | Serve para |
|---|---|---|
| Chave de API | O seu sistema pergunta | Ler ou escrever dados quando você quiser |
| Webhook | A OctoSolve avisa | Saber na hora que algo aconteceu, sem ficar perguntando |
| Servidor MCP | Uma IA de fora pergunta | Você comandar sua conta conversando, em português |
Uma comparação que ajuda: a chave de API é você ligar para alguém. O webhook é alguém te ligar. O MCP é você dar o telefone para o seu assistente usar.
1. Chaves de API
Uma chave de API é uma senha comprida que o seu sistema usa no lugar do seu login. Com ela, um programa consegue ler seus contatos, seus serviços e sua agenda, e, se você deixar, criar coisas novas.
Como criar
- Clique em Nova chave.
- Dê um nome que diga onde ela vai ser usada. Nome bom:
site da clínica. Nome ruim:chave 1. - Escolha o escopo:
- Leitura: o sistema só consulta. Não muda nada.
- Escrita: o sistema também cria e altera.
- Se quiser, defina uma validade.
- Clique em criar.
A chave aparece uma vez só, no momento em que é criada. Depois disso ninguém consegue ver ela de novo, nem você, nem a nossa equipe. Guarde na hora, num gerenciador de senhas. Se perder, é só revogar e criar outra.
Comece sempre pela leitura
Se o seu sistema só precisa mostrar informação, uma chave de leitura basta. Chave de escrita que vaza é alguém criando agendamento falso na sua agenda. Chave de leitura que vaza é ruim, mas é bem menos grave.
Exemplo real
Sua recepcionista quer uma tela simples que mostra os agendamentos de amanhã numa TV da sala de espera. Essa tela só lê. Então: chave de leitura, nome painel da recepção.
Se depois você quiser que o site da clínica também crie o agendamento quando o paciente preenche um formulário, aí sim precisa de uma chave de escrita, separada, com o nome site da clínica. Duas chaves, dois nomes, dois escopos. Se um dia o site der problema, você revoga a dele sem derrubar a TV da recepção.
Quantas você pode ter
| Plano | Chaves ativas ao mesmo tempo |
|---|---|
| Plus | 3 |
| Pro | 5 |
Chave revogada não conta. Se bater no limite, revogue uma que não usa mais.
Revogar
Clique em revogar e pronto. O acesso cai em até um minuto. Faça isso na hora se:
- Alguém que tinha acesso saiu da empresa.
- A chave foi parar num lugar público, tipo um repositório de código ou um print.
- Você não lembra mais para que ela serve.
Quem cria e revoga chave é o dono da conta. Atendente não vê esta seção.
2. Webhooks de saída
Webhook é o contrário da chave de API. Em vez do seu sistema ficar perguntando "aconteceu alguma coisa? e agora? e agora?", a OctoSolve avisa ele no momento em que acontece.
Como funciona na prática
Você informa um endereço da internet que o seu sistema controla. Toda vez que um dos eventos acontece, a gente manda uma mensagem para lá, na hora.
Os eventos que você pode assinar
| Evento | Quando dispara |
|---|---|
| Contato criado | Alguém novo aparece na sua base |
| Contato atualizado | Um dado do contato mudou |
| Agendamento criado | Um horário foi marcado |
| Agendamento alterado | Mudou horário, profissional ou situação |
| Agendamento cancelado | O horário caiu |
| Conversa iniciada | Alguém começou a falar com o agente |
| Conversa encerrada | O atendimento fechou |
Você escolhe quais quer. Não precisa assinar todos.
Exemplo real
Você quer que todo agendamento novo caia numa planilha do Google, para a sua sócia acompanhar sem entrar na OctoSolve.
- Monte um endereço que receba os avisos. Ferramentas de automação como Make ou n8n dão esse endereço prontinho, sem programar.
- Cole o endereço em Novo webhook.
- Marque só Agendamento criado.
- Salve e guarde o segredo que aparece.
- Na ferramenta de automação, mande o conteúdo para a linha nova da planilha.
Pronto: agendou pelo WhatsApp, apareceu na planilha em segundos.
O segredo, e por que ele importa
Junto com o webhook nasce um segredo. Ele serve para o seu sistema ter certeza de que a mensagem veio mesmo da OctoSolve, e não de alguém que descobriu o seu endereço e resolveu mandar agendamento falso.
O segredo aparece uma vez só, igual à chave.
Se o seu endereço for público e você não conferir a assinatura, qualquer pessoa que descobrir esse endereço consegue mandar aviso falso para o seu sistema. Confira sempre.
Quando o aviso não chega
Se o seu sistema estiver fora do ar, a gente tenta de novo algumas vezes, com espera crescente entre as tentativas. Não é uma tentativa só. Mas também não é para sempre: sistema que fica dias fora perde os avisos daquele período.
A tela mostra as últimas entregas, com o que deu certo e o que falhou. Comece por aí quando algo não chegar.
3. Servidor MCP
Esta é a parte que mais confunde, então vamos pelo começo.
O MCP não faz nada sozinho
Ligar o servidor MCP e ficar olhando a tela não produz efeito nenhum. Isso não é defeito.
O MCP é uma porta. Ele deixa uma inteligência artificial de fora entrar e usar as ferramentas da sua conta. Quem age é essa IA, não o servidor. É como destrancar a porta de casa: a porta destrancada não traz visita, ela só deixa entrar quando alguém chega.
Então o fluxo é:
- Você liga o servidor e escolhe o que fica liberado.
- Você conecta uma IA sua a ele. Pode ser o Claude, por exemplo.
- Aí sim você conversa com essa IA, e ela usa a sua conta.
O que dá para fazer depois de conectar
Coisas assim, escrevendo em português normal para a IA:
- "Quais horários o doutor tem livres na quinta?"
- "Quanto custa a limpeza e o clareamento juntos?"
- "Cria um contato para a Ana, telefone tal."
- "Marca a Ana para limpeza na quinta às 14h."
- "Quantos agendamentos eu tenho na semana que vem?"
Você não abre a OctoSolve para nada disso. Fala com a IA e ela busca.
As três travas
Uma chamada só passa se as três estiverem abertas. Se qualquer uma estiver fechada, a IA recebe uma recusa.
- O servidor está ligado? É a chave geral.
- Aquela ferramenta específica está ligada? São 13, uma a uma.
- A credencial tem permissão? Uma credencial de leitura nunca escreve, mesmo com a ferramenta ligada.
Isso é de propósito. Trava demais é chato uma vez. Trava de menos é a IA remarcando o paciente errado.
As 13 ferramentas
Elas vêm em quatro grupos.
| Grupo | Lê | Escreve |
|---|---|---|
| Contatos | buscar, ver um | criar, atualizar |
| Catálogo | listar serviços, ver um | nenhuma |
| Equipe | listar profissionais, ver um | nenhuma |
| Agenda | ver horários livres, listar agendamentos, ver um | criar, alterar |
As nove de leitura já vêm ligadas. As quatro de escrita começam desligadas, e ligar cada uma é uma decisão sua.
Como as nove de leitura já nascem ligadas, o botão "Ligar ferramentas de leitura" fica apagado numa conta nova. Não é bug: não há o que ligar.
Os três níveis de risco
Cada ferramenta tem uma etiqueta.
| Etiqueta | O que significa | Exemplo |
|---|---|---|
| Baixo | Só lê. Não muda nada. | ver horários livres |
| Médio | Muda dado seu, e ninguém de fora fica sabendo. | criar contato |
| Alto | Pode ocupar a agenda de um profissional, ou avisar o seu cliente final. | criar agendamento, alterar agendamento |
Ligar uma de risco alto abre uma confirmação antes. Vale a pena parar e ler: um erro da IA aqui vira uma pessoa de verdade recebendo mensagem errada, ou um horário ocupado à toa.
Comece pequeno
Recomendação honesta: ligue só as de leitura, use por uma semana, veja o que a IA faz. Se a experiência for boa e você quiser que ela também marque horário, aí ligue as de escrita. Não há pressa, e desligar depois é um clique.
Conectar
O jeito mais fácil é conectar direto pelo aplicativo de IA, sem chave nenhuma:
- Ligue o servidor MCP e clique em salvar.
- No seu aplicativo de IA, adicione um conector novo e cole o endereço que aparece na tela.
- O aplicativo te leva para uma tela da OctoSolve. Entre com a sua conta.
- Confira o endereço que aparece na tela de autorização, antes de aprovar. Ele diz para onde o acesso está indo.
- Aprove. As ferramentas aparecem no seu aplicativo.
Na tela de autorização, o nome do aplicativo é escrito por quem fez o aplicativo, então dá para escrever qualquer coisa ali. O que não dá para falsificar é o endereço de retorno, que mostramos junto. Se o nome diz uma coisa e o endereço é de um site que você não conhece, recuse.
Para uso mais técnico, ou dentro de um programa seu, a conexão por chave de API continua existindo e está descrita na documentação de desenvolvedor.
Mudou alguma coisa? Reconecte
Ligou uma ferramenta nova, desligou outra, trocou de plano? O aplicativo de IA só enxerga a mudança quando reconecta. Ele guarda a lista de ferramentas de quando conectou. Se você ligou algo e a IA insiste que não consegue, desconecte e conecte de novo.
O registro de uso
A tela mostra as últimas chamadas: qual ferramenta, qual credencial, quando, e se deu certo. Serve para você conferir o que a IA andou fazendo.
O registro não guarda o conteúdo das chamadas, só o fato de terem acontecido. A gente sabe que a IA buscou um contato, não qual contato.
Perguntas que aparecem sempre
Liguei o servidor MCP e não aconteceu nada. Está quebrado? Não. O MCP é uma porta, e porta aberta não traz visita. Conecte um aplicativo de IA a ele.
Qual a diferença entre chave de API e MCP? A chave é para um programa que alguém escreveu. O MCP é para você conversar com uma IA em português. Por baixo, os dois chegam nos mesmos dados.
Preciso saber programar? Para o MCP, não. Para webhook, quase não: ferramentas de automação resolvem sem código. Para chave de API, sim, alguém precisa escrever o programa que usa ela.
A IA vê as conversas dos meus clientes? Não. As 13 ferramentas cobrem contatos, serviços, profissionais e agenda. Conversa não está entre elas.
E o CPF? Nunca sai. Ele é removido de tudo que passa pela API e pelo MCP, mesmo que a ferramenta pareça devolver o contato inteiro.
Alguém da minha equipe pode mexer nisso? Não. Chaves, webhooks e MCP são só do dono da conta.
Perdi minha chave. Como recupero? Não recupera. Revogue e crie outra. Isso é de propósito: chave que a gente conseguisse mostrar de novo seria chave que a gente guarda em texto, e não guardamos.