WeSpeak MCP Connection

O WeSpeak MCP é o conector oficial do WeSpeak para o Claude (claude.ai) e o ChatGPT na web (chatgpt.com): ele oferece à sua IA 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 assistentes de IA se conectam a ferramentas externas. Como as ferramentas do WeSpeak convivem com as outras que você tiver conectadas, dá para pedir à sua IA 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
• 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) ou do ChatGPT acessada pela web (chatgpt.com) que permita adicionar conectores MCP personalizados. A disponibilidade depende do plano e, em um espaço de trabalho gerenciado, das configurações dele.
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

Copie os dados de conexão da sua conta

No painel do WeSpeak, entre em Configuração e encontre WeSpeak MCP Connection. Copie o nome sugerido para o conector, a URL do servidor da sua conta e o Client ID dessa seção.

• Cole a URL do servidor exatamente como aparece, incluindo ?username=.... Esse valor identifica a conta do WeSpeak, não a pessoa que faz login. Não corte a URL nem use a de outra conta.
• O Client ID é um identificador público, não uma senha. Use o mesmo valor no Claude e no ChatGPT. Deixe Client Secret vazio se o formulário pedir esse campo.
• Entre com seu usuário habitual do WeSpeak quando o app abrir a tela de autorização. Você não precisa cadastrar manualmente uma URL de callback ou redirecionamento.

Se o botão Copiar prompt de conexão estiver disponível nessa seção, você pode copiar as instruções com os dados da sua conta e colá-las no Claude ou no ChatGPT para receber ajuda. Sua IA pode orientar você; o que ela consegue fazer automaticamente depende do acesso ao navegador e às configurações. Você ainda faz o login no WeSpeak. As etapas manuais abaixo também funcionam sem esse botão.

Conectar pelo Claude (claude.ai)

1. Em um plano pessoal, abra Customize → Connectors → Add → Add custom connector. No Team ou Enterprise, uma pessoa proprietária da organização adiciona o conector em Organization settings → Connectors → Add → Custom (escolha Web se solicitado); depois, os membros abrem Customize → Connectors para conectá-lo. Se o WeSpeak já estiver na lista, pule as etapas de criação e conecte-o. Esses nomes correspondem à interface do Claude em inglês.
2. Preencha Name com o nome copiado e cole a URL exata do servidor do WeSpeak em MCP server URL.
3. O diálogo varia conforme a organização. No diálogo de duas etapas, clique em Continue, escolha Sign in now em Authentication e depois Use your own OAuth client em OAuth client. Cole o Client ID do WeSpeak em OAuth client ID e deixe OAuth client secret (optional) vazio. No diálogo de uma única tela, abra Advanced settings para informar o Client ID e deixar o secret vazio. Não escolha registro automático: esta conexão usa o cliente OAuth fornecido pelo WeSpeak.
4. Clique em Add para concluir a adição do conector e em Connect se solicitado. Entre com seu usuário habitual do WeSpeak e autorize o acesso quando o Claude solicitar. Aguarde a conclusão da autorização e o redirecionamento de volta ao Claude.
5. Abra um chat novo, selecione + → Connectors e habilite o WeSpeak.

O vídeo na aba Claude da Configuração do WeSpeak serve de referência para a conexão. Os menus e o diálogo podem ser diferentes dos mostrados no vídeo; siga as etapas acima e o guia de conectores personalizados do Claude.

Conectar pelo ChatGPT na web (chatgpt.com)

1. Abra ChatGPT Plugins, clique em + e escolha Add custom MCP server. Se essa opção não aparecer, confira se a sua conta e o espaço de trabalho permitem plugins MCP personalizados.
2. Preencha Name com o nome copiado e, se quiser, adicione uma descrição em Description. Em Connection, mantenha Server URL selecionado e cole a URL exata do servidor da sua conta, incluindo ?username=....
3. Em Authentication, escolha OAuth e abra Advanced OAuth settings. Em Client registration, selecione User-Defined OAuth Client em Registration method. Cole o Client ID do WeSpeak em OAuth client ID, deixe OAuth client secret vazio e mantenha Token endpoint auth method em none.
4. Leia o aviso de conexão, marque I understand and want to continue e clique em Create as a plugin. Conclua o login e a autorização do WeSpeak quando o ChatGPT solicitar.
5. Instale o plugin criado e selecione-o em um chat novo usando @.

Esses nomes correspondem à interface do ChatGPT em inglês; as traduções e a disponibilidade podem variar conforme a conta ou o espaço de trabalho. Consulte o guia da OpenAI para conectar um servidor MCP personalizado.

Verifique a conexão

Abra um chat novo no app conectado e habilite ou selecione as ferramentas do WeSpeak se o chat exigir essa etapa. Peça uma verificação somente de leitura, por exemplo:

A qual conta do WeSpeak esta conexão está vinculada? Liste as ferramentas disponíveis para mim. Leia a configuração do assistente se o meu perfil permitir; caso contrário, busque o guia de ajuda sobre conversas. Não altere dados nem envie mensagens.

As ferramentas disponíveis dependem do seu perfil. Confirme que a conexão identifica a conta desejada antes de usá-la para fazer alterações.

ℹ️ Cada pessoa da equipe conecta o próprio usuário do WeSpeak pela própria conta do Claude ou do ChatGPT. Não compartilhem usuários: as edições de conhecimento e os reportes ficam atribuídos à pessoa que os 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: sua IA escolhe a ferramenta conforme o que você pedir.

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

Sua IA não executa só uma ferramenta por vez: ela encadeia várias em um mesmo pedido (buscar → ler → resumir → agir) e redige 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)

Ela 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, ela 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 ela vai alterar.

Leads e funil de vendas (Supervisor)

Ela 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." — sua IA 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 sua IA 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 ela 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 app de IA (planilhas, documentos, mensageria), pode pedir que a IA 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)

Ela 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: sua IA vai indicar onde cada coisa é configurada (veja a próxima seção).

Controle de qualidade do assistente (Administrador)

Com as mensagens de teste, sua IA 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 peça à sua IA que confirme com você antes de aplicar a mudança.
• 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?" — sua IA 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 pela sua IA, ela 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. Pelo MCP 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: sua IA age conforme o que você pede, sem um passo extra de confirmação do WeSpeak no meio. Revise o que ela 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: sua IA 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 a sua IA nem o que ela responde; só recebe as ações que ela executa na sua conta.
• Revogável quando quiser: remova o conector nos ajustes do seu app de IA 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, permitindo uma conexão separada por conta), que você copia da tela Configuração do painel daquela conta. Você pode manter as conexões no mesmo app de IA; cada uma se anuncia com o nome da sua conta e vê só os próprios dados. Ao pedir algo à sua IA, diga de qual propriedade se trata, para que ela use a conexão certa.

Solução de problemas

Limites atuais

• Este guia cobre o Claude (claude.ai) e o ChatGPT na web (chatgpt.com). Para apps de desktop, Gemini ou outros clientes MCP, consulte seu consultor sobre a compatibilidade e a configuração do app específico. Não presuma que as mesmas etapas se aplicam.
• 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

Funciona com o ChatGPT?
Sim, com o ChatGPT na web. Use os dados da aba ChatGPT em Configuração, escolha OAuth com o Client ID do WeSpeak e deixe Client Secret vazio. Sua conta do ChatGPT precisa permitir conectores MCP personalizados.

Substitui o assistente do painel?
Não, eles convivem: as mesmas ferramentas continuam disponíveis no painel e, além disso, na sua IA conectada. 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 ou do ChatGPT — o WeSpeak não cobra por consulta. Confirme com seu consultor se a função está incluída no seu plano.

Minha IA conectada 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 a própria conta do Claude ou do ChatGPT com o próprio usuário do WeSpeak e vê as ferramentas do seu perfil.

O que eu faço pelo MCP vale igual a fazer pelo painel?
Sim — e fica registrado no seu nome. Sua IA age na sua conta a partir do que você pede, então revise o que ela 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 seu app de IA e o acesso do seu usuário é cortado. Se quiser desativar a função para a conta inteira, peça ao seu consultor.