O WeSpeak MCP é o conector oficial do WeSpeak para o Claude (claude.ai): ele adiciona ao seu Claude as mesmas ferramentas do assistente que você já usa no painel, para operar sua conta conversando com a sua própria IA — buscar conversas, mover leads, consultar métricas, editar o conhecimento do seu assistente ou pausá-lo — sem entrar no painel.
MCP (Model Context Protocol) é o protocolo padrão com o qual IAs como o Claude se conectam a ferramentas externas. Como as ferramentas do WeSpeak convivem com as outras que você tiver conectadas, dá para pedir ao Claude coisas que o painel não faz: por exemplo, um relatório que cruze suas métricas do WeSpeak com suas planilhas.
Neste artigo
- O que você precisa
- Como conectar
- O que cada perfil pode fazer
- O que ele pode modificar (e o que não)
- Segurança e privacidade
- Se você administra várias propriedades
- Solução de problemas
- Limites atuais
- Perguntas frequentes
O que você precisa
- A função ativada na sua conta — isso é feito pelo seu consultor da WeSpeak. Ao ativar, seus dados de conexão aparecem na tela Configuração do painel.
- Uma conta do Claude (claude.ai) que permita adicionar conectores.
- Seu usuário do WeSpeak de sempre. Não há chaves novas nem API keys: o acesso é autorizado ao iniciar sessão, e cada ação respeita o perfil do seu usuário.
Como conectar
- No painel do WeSpeak, entre em Configuração: você verá a seção Conectar o WeSpeak ao Claude, com seus dados prontos para copiar — o nome sugerido para o conector, a URL da sua conta e o Client ID — além do vídeo passo a passo.
- No claude.ai, vá em Settings → Connectors → Add custom connector (Configurações → Conectores → Adicionar conector personalizado).
- Dê a ele o nome sugerido (pode trocar) e cole a URL do servidor exatamente como copiou. Ela é exclusiva da sua conta — termina em
?username=seguido do seu usuário — e é o que identifica a sua conexão: não a corte nem use a de outra conta. - Nas configurações avançadas do conector, cole o Client ID (um identificador público, não uma senha). Não pule esse passo: sem ele a conexão falha.
- Adicione o conector: ele aparece na sua lista de conectores. Toque em Connect no do WeSpeak — abre o login do WeSpeak: entre com seu usuário de sempre e autorize o acesso. Esse passo pode levar até 30 segundos; aguarde o Claude redirecionar você de volta.
- Pronto — em um chat novo, o Claude já tem as suas ferramentas do WeSpeak. Teste com "busque as conversas de ontem que ficaram sem resposta".
ℹ️ Cada pessoa da equipe conecta o próprio usuário a partir do próprio Claude. Não compartilhem usuários: assim cada ação fica registrada em nome de quem a fez.
O que cada perfil pode fazer
As regras são as mesmas do painel: cada usuário vê só as ferramentas que o seu perfil permite, e os perfis superiores somam as dos inferiores.
| Perfil | O que pode fazer |
|---|---|
| Operador (todos os perfis) | Buscar conversas e ler as mensagens · consultar uma reserva (requer WeSpeak Payments) · buscar nos guias de ajuda · diagnosticar uma resposta do assistente que saiu errada e reportá-la à nossa equipe. |
| Supervisor | Além disso: atribuir, fechar, reabrir ou adiar conversas · buscar leads, movê-los de etapa e consultar as etapas do funil · consultar métricas. |
| Administrador | Além disso: ver e editar o conhecimento do assistente · enviar mensagens de teste a ele · pausá-lo ou reativá-lo. |
ℹ️ Na lista de ferramentas do conector você verá nomes técnicos em inglês (
searchConversations,knowledgeAssistant,testAssistant…). Não precisa memorizá-los: o Claude escolhe a ferramenta conforme o que você pedir.
O que ele pode modificar (e o que não)
A maioria das ferramentas só consulta. Do Claude só é possível:
- Pausar ou reativar o assistente. É a única parte editável da configuração dele: os horários de atendimento e o fuso horário podem ser vistos, mas são alterados no painel.
- Editar o conhecimento do assistente. Cada mudança é validada antes de ser aplicada, guarda um backup e pode ser desfeita.
- Mudar o status de uma conversa (atribuir, fechar, reabrir ou adiar). Ele nunca edita o conteúdo das mensagens.
- Mover um lead de etapa. As etapas do funil podem ser consultadas, mas a estrutura não é editada por aqui.
- Reportar um problema à nossa equipe quando uma resposta do assistente saiu errada.
As mensagens de teste são simulações: não ficam guardadas nem chegam a ninguém. E o conector não envia mensagens aos seus hóspedes: ele serve para operar sua conta, não é um canal de atendimento — seu assistente de WhatsApp continua atendendo como sempre.
⚠️ Importante: o Claude age conforme o que você pede, sem um passo extra de confirmação do WeSpeak no meio. Revise o que ele propõe antes de mandar aplicar — principalmente ao editar conhecimento. Como rede de segurança, essas mudanças guardam backup e podem ser desfeitas.
Segurança e privacidade
- Suas permissões de sempre: o Claude pode fazer exatamente o mesmo que você pode fazer no painel com o seu usuário — nem mais, nem menos — e só vê os dados da sua conta.
- Tudo fica no seu nome: as edições de conhecimento e os reportes registram quem os fez.
- Sua conversa é privada: o WeSpeak não vê o que você conversa com o seu Claude nem o que o Claude responde; só recebe as ações que ele executa na sua conta.
- Revogável quando quiser: remova o conector nos ajustes do Claude e o acesso do seu usuário é cortado. Se quiser desativar a função para a conta inteira, peça ao seu consultor.
Se você administra várias propriedades
Cada conexão fica vinculada a uma conta do WeSpeak. Para administrar várias propriedades, adicione uma conexão por conta: cada conta tem a sua própria URL de conexão (o final ?username= as distingue, e o Claude trata cada URL como um conector separado), que você copia da tela Configuração do painel daquela conta. Todas convivem no mesmo Claude, cada uma se anuncia com o nome da sua conta e vê só os próprios dados. Ao pedir algo ao Claude, diga de qual propriedade se trata, para que ele use a conexão certa.
Solução de problemas
| O que você vê | O que fazer |
|---|---|
| Ao conectar ou autorizar, a conexão é rejeitada | A função pode ainda não estar ativada, ou a URL colada é de uma conta diferente da do usuário com que você entrou — típico ao administrar várias propriedades: o WeSpeak valida que coincidam. Copie a URL da tela Configuração do painel daquela conta, entre com um usuário dessa mesma conta e, se continuar falhando, fale com seu consultor. |
| Conectou bem, mas as ferramentas de métricas ou de conhecimento não aparecem | É o perfil: métricas pedem Supervisor ou superior; conhecimento, testes e pausar o assistente pedem Administrador. Revise os perfis na seção Equipe. |
| Ao consultar uma reserva ele responde que você precisa do WeSpeak Payments | Essa ferramenta usa o módulo de pagamentos; todo o resto funciona igual sem ele. Se tiver interesse em cobrar pelo chat, fale com seu consultor. |
| Uma ferramenta demora vários minutos | É normal nas que usam IA por dentro (editar conhecimento, diagnosticar uma resposta), com um teto de uns 5 minutos por execução. Se cortar com erro, tente de novo. |
Limites atuais
- Hoje funciona com o Claude (claude.ai). O ChatGPT por enquanto não consegue se conectar — falta um suporte técnico do nosso lado para o login dele funcionar — e o Gemini não permite conectar esse tipo de ferramenta. Outros apps compatíveis com MCP podem precisar ser habilitados antes por nós: consulte seu consultor, contando qual app você usa.
- Não envia mensagens a hóspedes nem muda como o seu assistente atende o WhatsApp.
- É uma ferramenta conversacional jovem. Se uma ferramenta responder estranho ou um pedido não sair como esperado, reporte ao seu consultor: isso nos ajuda a melhorá-la.
Perguntas frequentes
Substitui o assistente do painel?
Não, eles convivem: as mesmas ferramentas continuam disponíveis no painel e, além disso, no seu Claude. Use cada um onde for mais cômodo.
Tem custo adicional? Quem paga a IA?
O uso da IA corre pela sua assinatura do Claude — o WeSpeak não cobra por consulta. Confirme com seu consultor se a função está incluída no seu plano.
O Claude pode responder aos meus hóspedes?
Não. O conector opera a sua conta (conversas, leads, métricas, conhecimento), mas não escreve para ninguém. Detalhe: editar o conhecimento por aqui impacta o que o seu assistente responde — igual a editá-lo pelo painel.
Várias pessoas da equipe podem se conectar?
Sim: cada uma conecta o próprio Claude com o próprio usuário do WeSpeak e vê as ferramentas do seu perfil.
O que eu faço pelo Claude vale igual a fazer pelo painel?
Sim — e fica registrado no seu nome. O Claude age na sua conta a partir do que você pede, então revise o que ele propõe antes de aplicar; as mudanças de conhecimento guardam backup e podem ser desfeitas.
Como eu desconecto?
Remova o conector do WeSpeak nos ajustes do Claude e o acesso do seu usuário é cortado. Se quiser desativar a função para a conta inteira, peça ao seu consultor.