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 e o ChatGPT.

Você não precisa dela para o agente atender no WhatsApp. Isso já funciona sozinho. Integrações é para quando você quer ir além.

Onde fica

Configurações → Integrações. Só o dono da conta vê esta aba. Atendente não vê, e isso é de propósito: aqui se cria credencial que dá acesso aos dados do negócio inteiro.

As quatro coisas que moram aqui

Elas parecem parecidas e não são. A diferença é quem começa a conversa.

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. E os aplicativos conectados são a lista de quem está com a chave da sua casa.

Não sei qual eu preciso

• Quer que o seu site mostre os horários livres e marque horário? Chave de API.
• Quer que a sua planilha encha sozinha quando alguém agenda? Webhook.
• Quer conversar com o Claude ou o ChatGPT e pedir "me monta um relatório do mês" ou "cria uma automação"? Servidor MCP.
• Só quer saber quem tem acesso e tirar? Aplicativos conectados.

---

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.

1 cria uma chave nova. 2 é o escopo, que decide se aquela chave só lê ou também escreve. 3 revoga na hora, e não tem volta.

Repare que a coluna Prefixo só mostra o comecinho da chave. Isso não é censura da imagem: é assim na tela mesmo. A chave inteira aparece uma vez só, quando você cria.

Como criar

1. Clique em Nova chave.
2. Dê um nome que diga onde ela vai ser usada. Nome bom: site da clínica. Nome ruim: chave 1.
3. Escolha o escopo:
   • Somente leitura: o sistema só consulta. Não muda nada.
   • Leitura e escrita: o sistema também cria, atualiza e apaga.
4. Em Ferramentas do MCP, deixe Todas as ferramentas da conta (o padrão) ou marque Escolher ferramentas para a chave enxergar só algumas. Quem manda é a conta: a chave nunca usa uma ferramenta que está desligada no Servidor MCP.
5. Se quiser, preencha Expira em. Em branco, a chave nunca expira.
6. Clique em Criar chave.

Comece sempre pela leitura

Dá vontade de já criar com escrita, para não ter que voltar depois. Não faça isso. Uma chave de leitura que vaza é um susto. Uma chave de escrita que vaza pode virar agendamento falso na sua agenda e mensagem enviada para o seu cliente.

Crie leitura, faça funcionar, e só troque para escrita quando o sistema realmente precisar criar alguma coisa.

Exemplo real

A clínica quer mostrar os horários livres no próprio site.

O site não precisa criar nada, só consultar. Então: chave de leitura, nome site da clínica. O desenvolvedor do site usa essa chave para perguntar quais horários estão livres no dia e monta a telinha de agendamento.

Se um dia o site for trocado de empresa, você revoga aquela chave e cria outra. Ninguém mais precisa mexer em senha nenhuma.

Quantas você pode ter

Chave revogada não conta. O limite é de chaves vivas.

Quantos pedidos cabem por dia

O mesmo teto vale para chave de API e para o MCP, porque os dois falam com a mesma API.

Passou do teto, os pedidos seguintes são recusados até a janela virar. Uso normal não chega perto disso: o teto existe para segurar programa com defeito em laço, não para limitar o seu dia a dia.

Nem todo pedido pesa igual

Uma pergunta simples, tipo "lista meus serviços", é 1 pedido. Já "me dá o relatório do mês" faz o sistema abrir doze consultas de uma vez, porque ele junta agenda, dinheiro, conversas e canais no mesmo número.

Cobrar 1 pelas duas seria mentir com o número. Então as ferramentas que consultam muito gastam mais do seu limite, e algumas esperam alguns segundos entre uma chamada e outra:

Todas as outras gastam 1 e não esperam nada.

Por que a espera existe. A mesma estrada que a sua integração usa é a que o agente usa para responder o seu cliente no WhatsApp. Trinta relatórios disparados no mesmo minuto cabem no teto, mas chegam em rajada e deixam a mensagem do seu cliente na fila. A espera transforma rajada em fila organizada, sem impedir o uso.

Na tela de Integrações, essas ferramentas aparecem com o selo Consulta pesada. Passe o mouse nele para ver o número.

Revogar

Revogar é imediato e não tem volta. O sistema que estava usando aquela chave para de funcionar no mesmo segundo.

Revogue quando: alguém saiu da empresa, você desconfia que a chave vazou, ou o sistema que usava ela não existe mais.

---

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.

1 cadastra um endereço novo. 2 troca o segredo sem apagar o endereço, para quando você desconfia que ele vazou. 3 abre a lista das últimas entregas, que é por onde você começa quando o aviso não chegou.

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

São oito, e a tela mostra exatamente estes nomes:

Você escolhe quais quer. Não precisa assinar todos, e assinar demais só enche o seu sistema de aviso que ninguém lê.

Na janela Novo endpoint, o Nome é obrigatório e serve só para você reconhecer o endereço na lista.

Exemplo real

Você quer que todo agendamento novo caia numa planilha do Google, para a sua sócia acompanhar sem entrar na OctoSolve.

1. Monte um endereço que receba os avisos. Ferramentas de automação como Make ou n8n dão esse endereço prontinho, sem programar.
2. Clique em Novo endpoint, dê um Nome (por exemplo, planilha da sócia) e cole o endereço no campo URL.
3. Marque só Agendamento criado.
4. Salve e guarde o segredo que aparece.
5. Na ferramenta de automação, mande o conteúdo para a linha nova da planilha.

Pronto: agendou pelo WhatsApp, apareceu na planilha em segundos.

Outro exemplo real

A recepção usa outro sistema, e você quer que ele saiba do cancelamento na hora.

Assine só Agendamento cancelado e aponte para o endereço do seu sistema. Quando o cliente cancelar pelo WhatsApp às onze da noite, o sistema da recepção já acorda sabendo que aquele horário abriu.

Quantos endpoints você pode ter

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.

Como saber se um aviso é repetido, ou velho

Todo aviso vai com quatro informações no cabeçalho, e elas resolvem os dois sustos mais comuns:

Por que isso importa. Se a sua internet cair bem na hora em que você já tinha processado o aviso, a gente tenta de novo, porque não recebeu a confirmação. Com o código da entrega você percebe que é o mesmo aviso e não cria o agendamento duas vezes.

E com a hora do fato você decide o que ainda vale: um cancelamento de duas horas atrás pode não fazer mais sentido no seu sistema.

Quando o aviso não chega

Se o seu sistema estiver fora do ar, a gente tenta de novo, com espera crescente. Quanto tempo a gente insiste depende do evento, porque nem todo aviso envelhece igual:

A espera entre uma tentativa e a próxima cresce assim: 1 minuto, 5 minutos, 30 minutos, 2 horas e 6 horas. Os eventos de agenda e de atendimento param na 4ª tentativa, depois da espera de 30 minutos.

A ideia é simples: um cancelamento entregue no dia seguinte atrapalha mais do que ajuda, porque o seu sistema ia liberar uma vaga que já foi embora. Já um pagamento vale a insistência.

Depois da última tentativa, aquele aviso se perde.

E se o seu endereço falhar 20 vezes seguidas, a gente desliga o endpoint sozinho, para não ficar batendo em porta que não abre. Ele fica na tela, desligado, esperando você arrumar e religar.

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 existe para uma IA de fora, o Claude ou o ChatGPT que você já usa, entrar e conseguir mexer na sua conta. Enquanto você não conectar essa IA do outro lado, nada acontece.

1 liga a porta. 2 é o endereço que você vai colar no seu aplicativo de IA. 3 salva as ferramentas que você escolheu.

O que dá para fazer depois de conectar

Coisas que o dono de clínica pede no dia a dia, em português, sem abrir o painel:

• "Quantos agendamentos eu tive esse mês, e quanto entrou de dinheiro?"
• "Marca a Ana na quinta às 15h com a doutora Paula."
• "Quais horários estão livres amanhã de manhã?"
• "Cria um documento na base explicando a nossa política de convênio."
• "Cria uma automação que avisa a equipe quando alguém falar em cancelar."

As travas

Nada disso fica aberto por acaso. Existem três travas, e todas precisam estar abertas:

1. O servidor precisa estar ligado. Desligou, ninguém entra, nem quem já estava conectado.
2. Cada ferramenta tem a sua chavinha. Ligar o servidor não libera tudo. Você escolhe uma a uma.
3. A credencial tem escopo. Credencial de leitura não escreve, mesmo que a ferramenta esteja ligada.

Quem entra com uma chave de API que escolheu ferramentas tem uma quarta trava: a ferramenta precisa estar na lista daquela chave.

Basta uma trava fechada para o pedido ser recusado.

As 25 ferramentas

1 liga de uma vez todas as de leitura, que são as seguras (quando falta alguma, o botão diz Ligar ferramentas de leitura com a quantidade). 2 é o selo de risco, que aparece em cada ferramenta.

Na primeira vez que você abre, as 16 de leitura já aparecem marcadas. Isso é só uma sugestão de ponto de partida: enquanto você não clicar em Salvar alterações, nada está liberado de verdade, e a tela avisa isso.

Elas vêm separadas em sete grupos:

Os três níveis de risco

As 16 de leitura já vêm ligadas. As 9 de escrita começam desligadas e exigem uma decisão sua, uma a uma.

O grupo Automações

É o mais novo, e o que mais muda o dia a dia de quem não gosta do editor de fluxos.

Exemplo real. Você fala com o Claude: "cria uma automação que, quando alguém falar em cancelar, avisa minha equipe, marca o contato com a etiqueta risco e move o card para a coluna de perdido". Ele consulta as suas etiquetas e as suas fases de verdade, monta a automação, e ela aparece no menu Fluxo (Automações) já montada, esperando você conferir.

Apagar também pede confirmação em dois passos. Desligar não pede nada, porque parar é sempre seguro.

Comece pequeno

Ligue só o grupo de leitura, conecte a IA e brinque um pouco. Peça relatório, peça horário livre, peça a lista de serviços. Quando estiver confortável, ligue uma ferramenta de escrita por vez.

Conectar

1. Ligue o Servidor MCP.
2. Escolha as ferramentas e clique em Salvar alterações.
3. Copie o endereço do servidor.
4. No seu aplicativo de IA, adicione um conector novo e cole o endereço.
5. Ele abre uma tela da OctoSolve. Entre com sua conta, confira o endereço de retorno em destaque e aprove.

Mudou alguma coisa? Reconecte

Ligou uma ferramenta nova e a IA não enxerga? É esperado. O aplicativo de IA guarda a lista de ferramentas em memória.

Antes de qualquer coisa, volte nesta tela e confira que o Servidor MCP está ligado e que a ferramenta que você quer está marcada. Com o servidor desligado nada funciona, por mais que você reconecte.

Feito isso, vá nas configurações do conector no seu aplicativo de IA, peça para atualizar a lista de ferramentas, e comece uma conversa nova. Só assim ele enxerga o que mudou.

No Claude, o caminho é Configurações, depois Conectores, clicar no conector da OctoSolve e usar a opção de atualizar as ferramentas. No ChatGPT o caminho tem outro nome, mas fica no mesmo lugar: nas configurações do próprio conector.

O registro de uso

A tela mostra as últimas chamadas que a IA fez: qual ferramenta, quando e se deu certo. O conteúdo enviado não é guardado, só o registro de que a chamada aconteceu.

Serve para responder "o que essa IA andou fazendo na minha conta?" sem depender de memória.

---

4. Aplicativos conectados

É assim que a seção aparece antes de você conectar qualquer coisa. Depois de aprovar o primeiro aplicativo, cada autorização vira uma linha, com o nome do aplicativo e o botão Revogar.

Aqui aparece tudo que você autorizou pelo caminho fácil do MCP, aquele que não usa chave. Chave de API não aparece nesta lista: ela mora na primeira seção.

Serve para uma coisa: cortar o acesso. Testou o ChatGPT e não gostou? Clique em Revogar. Um colaborador conectou a conta dele e saiu da empresa? Revogar também.

Revogar é imediato. A IA daquele aplicativo perde o acesso no mesmo segundo, e para voltar precisa passar de novo pela sua aprovação.

---

Perguntas que aparecem sempre

Preciso disso para o agente funcionar? Não. O agente atende no WhatsApp sem nada disso. Integrações é para conectar outros sistemas.

Qual a diferença entre chave de API e MCP? A chave é para um programa que alguém escreveu. O MCP é para uma IA que você usa conversando. Por baixo os dois falam com a mesma API.

Perdi minha chave. E agora? Revogue e crie outra. Ninguém consegue recuperar a chave antiga, nem a nossa equipe.

A IA pode apagar minha agenda inteira? Só se você tiver ligado as ferramentas de escrita da agenda. E cancelamento em massa esbarra no teto de pedidos por minuto da tabela acima. Se isso te preocupa, deixe ligadas só as de leitura: são 16 das 25, e já cobrem relatório, agenda, catálogo e base de conhecimento.

A IA lê minhas conversas com clientes? Não. Não existe ferramenta de conversa no MCP hoje. Ela vê contato, agenda, catálogo, base de conhecimento, números do relatório e automações.

Meu atendente vê essa aba? Não. Só o dono da conta.

---

Documentação técnica

Esta página é a explicação para quem usa a tela. Se você programa, ou se contratou alguém que programa, a documentação com endereços, formatos e códigos de erro fica em Desenvolvedor: