WeSpeak MCP Connection

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
• Situações de uso: o que você pode pedir a ele
• 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

1. 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.
2. Uma conta do Claude (claude.ai) que permita adicionar conectores.
3. 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

1. 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.
2. No claude.ai, vá em Settings → Connectors → Add custom connector (Configurações → Conectores → Adicionar conector personalizado).
3. 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.
4. 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.
5. 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.
6. 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.

ℹ️ 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.

Situações de uso: o que você pode pedir a ele

O Claude não executa só uma ferramenta por vez: ele encadeia várias em um mesmo pedido (buscar → ler → resumir → agir) e redige ele mesmo o resultado no formato que você pedir — uma lista, uma tabela, um relatório. Estes são exemplos reais do que você pode pedir, agrupados por tarefa; entre parênteses, o perfil mínimo necessário.

Operação diária das conversas (Operador · Supervisor para agir)

Ele busca por texto, status (abertas/fechadas), canal (WhatsApp, Instagram, Facebook), agente atribuído e intervalo de datas, e lê o histórico completo de uma conversa — incluindo as transcrições de áudios que já tenham sido geradas no painel.

• "Mostre as conversas abertas de hoje que ainda não têm agente atribuído."
• "Busque as conversas desta semana em que perguntam por late check-out ou early check-in."
• "Resuma a conversa com +55 11 … e diga o que ficou pendente de resposta."
• "Quais conversas do Instagram do fim de semana continuam abertas?"
• Com o perfil Supervisor, ele também age: "Atribua à Lucía as abertas de ontem que falam de grupos", "Feche as da semana passada que já têm reserva confirmada", "Adie esta conversa até segunda às 9".

💡 Para ações em lote (atribuir ou fechar várias), peça primeiro a lista e só depois a ação: assim você revisa exatamente o que ele vai mexer.

Leads e funil de vendas (Supervisor)

Ele lista os leads com filtros por texto, status, dias sem atividade e etapa do funil, e os move de etapa (ganho, perdido com motivo, ou para uma etapa específica).

• "Liste os leads que estão há mais de 5 dias sem atividade."
• "Quantos leads temos hoje em 'Cotado' e quem são?"
• "Marque o lead do García como perdido, motivo 'escolheu outro hotel'."
• "Monte uma tabela com os leads abertos, a etapa e a última atividade para eu passar à equipe de vendas."
• "Me dê os leads parados, leia as conversas deles e diga quais vale retomar primeiro e com que mensagem." — o Claude lê cada histórico, prioriza e propõe o texto; o envio você faz pelo painel.

Relatórios e estatísticas (Supervisor)

As métricas que o Claude pode consultar hoje são duas: volume (mensagens e conversas em um período, em dias — a última semana, os últimos 30 dias…) e funil (quantos leads há em cada etapa e quantos foram ganhos ou perdidos no período, com o nome de cada etapa). O restante ele monta contando e cruzando os resultados das buscas de conversas e leads. Alguns relatórios que você pode pedir exatamente assim:

• Relatório semanal de atividade: "Monte o resumo da semana: conversas e mensagens dos últimos 7 dias, comparados com a semana anterior, e as 5 perguntas mais repetidas."
• Relatório de funil: "Como está a conversão do funil nos últimos 30 dias? Quantos leads entraram, em que etapa está cada um e quantos fechamos."
• Distribuição por canal e por agente: "Das conversas desta semana, quantas entraram por cada canal e quantas cada agente tem atribuídas?"
• Backlog da equipe: "Quantas conversas abertas há por agente e quais estão há mais dias sem atualização?"
• Temas recorrentes e lacunas de conhecimento: "Leia as conversas dos últimos 3 dias e diga quais perguntas se repetem e em quais o assistente encaminhou a um consultor." — ideal para decidir o que acrescentar ao conhecimento.
• Follow-ups automáticos: "Para quantas conversas da semana foi enviada a mensagem de follow-up automático?"
• Leads parados por etapa: "Quantos leads estão há mais de 7 dias sem atividade em cada etapa do funil."
• Formato e exportação: "Transforme esse relatório em uma tabela que eu possa colar numa planilha", "Monte como um relatório curto para enviar por e-mail à gerência". Se você tiver outras ferramentas conectadas no seu Claude (planilhas, documentos, mensageria), pode pedir que ele salve ou compartilhe ali diretamente.

ℹ️ As métricas atuais não incluem tempos de resposta nem a divisão entre respostas do assistente e humanas. Os relatórios montados listando conversas vêm paginados: para volumes grandes, restrinja o período (uma semana, um mês) para que fiquem precisos.

Reservas (Operador · requer WeSpeak Payments)

• "Mostre as últimas reservas e o status delas."
• "Busque a reserva ABC123 e diga o que foi pago e o que falta."
• "O hóspede da reserva ABC123 escreveu algo depois de reservar?" — cruza a reserva com a conversa dela.

Conhecimento do assistente (Administrador)

Ele lê o conhecimento por campo ou por busca semântica, edita com validação, backup e verificação, e pode desfazer. É a forma de manter atualizado o que o assistente virtual responde.

• Auditar: "O que o conhecimento diz hoje sobre pets, estacionamento e horário de check-in?", "Busque no conhecimento tudo relacionado a cancelamentos e diga se há contradições."
• Atualizar dados: "Mude o horário do café da manhã para 7h30–10h30", "Atualize o link de reservas", "Adicione as instruções para pagar por transferência."
• Regras de comportamento: "Que ele não prometa avisar quando um pagamento for verificado", "Que antes de cotar ele sempre pergunte as datas e a quantidade de pessoas."
• Quando encaminhar a um humano: "Quando perguntarem por eventos ou casamentos, que o assistente encaminhe a um consultor."
• Histórico e desfazer: "Que mudanças foram feitas no conhecimento esta semana e quem as fez?", "Desfaça a última mudança."
• Vários complexos: diga qual ("…só no complexo da praia") ou peça para aplicar em todos.

ℹ️ Promoções e descontos, descrições e fotos de quartos e horários de atendimento não são editados daqui: o Claude vai indicar onde cada coisa é configurada (veja a próxima seção).

Controle de qualidade do assistente (Administrador)

Com as mensagens de teste, o Claude pode se passar por um hóspede, inclusive em vários turnos, e comparar o que o assistente responde com o que deveria responder.

• "Pergunte ao assistente se aceitam pets e, no mesmo chat, o preço para 2 pessoas de 12 a 15 de outubro. Diga se ele respondeu bem."
• "Teste estas 10 perguntas frequentes e marque em quais a resposta foi incompleta ou incorreta" — e depois "corrija o conhecimento nas que falharam e teste de novo".
• Antes da temporada: "Verifique se o assistente responde bem sobre horários, políticas, formas de pagamento e como chegar, e corrija o que estiver desatualizado."
• Diagnóstico de uma resposta: "Nesta conversa o assistente disse que a piscina é aquecida e não é: por que ele disse isso?" — você recebe um veredito (falta de informação no conhecimento, erro real, não foi erro…) e, conforme o caso, a correção ou o reporte à nossa equipe.

Configuração e status (Administrador)

• "O assistente está ativo? Em que horário ele responde?"
• "Pause o assistente" / "Reative-o" — afeta todos os hóspedes da conta, por isso o Claude confirma com você antes.
• Os horários de atendimento são consultados daqui, mas alterados na tela Configuração do painel.

Ajuda sobre o WeSpeak (todos os perfis)

• "Como configuro as mensagens de follow-up?", "O que inclui o Multiconta?" — o Claude busca nestes guias e responde com o link do artigo.

Dicas para pedir bem

• Seja específico com período, canal e status: "abertas desta semana no Instagram" dá resultados melhores do que "as conversas".
• Lista primeiro, ação depois em qualquer mudança em lote.
• Nomeie a propriedade se você tiver várias contas conectadas.
• Peça o formato de que precisa (tabela, lista, relatório curto) e em que idioma.
• Se algo não puder ser feito pelo Claude, ele vai dizer e indicar se é feito no painel ou com o seu consultor.

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

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.