Guias

Como conectar o Grok Bot à sua caixa de entrada de suporte e deixar que novas mensagens de clientes o acordem

Conecte o Grok Bot à sua caixa de entrada de suporte como conector MCP personalizado, defina as regras dele com 5 perguntas e deixe um webhook acordá-lo quando um cliente escrever, em vez de um agendamento que gasta cota de uso com execuções vazias.

Deskwoot Team15 min de leitura
Conteúdo
  1. Antes de começar
  2. Como funcionam os conectores personalizados no Grok
  3. Passo 1: Adicione o Deskwoot como conector personalizado
  4. Passo 2: Responda às 5 perguntas de configuração
  5. Passo 3: Deixe o trabalho novo acordar o Grok
  6. Passo 4: Deixe o Fynn passar chats ao vivo para o Grok
  7. Teste antes que um cliente teste
  8. Começando pelo X com @bot
  9. Quanto custa
  10. O que o Deskwoot não consegue controlar
  11. Experimente com uma conversa de teste

Uma cliente escreve às 9h02 para perguntar onde está o pacote dela, e o Grok Bot que você conectou à sua caixa de entrada nem percebe. Uma rotina que confere tudo a cada poucos minutos pegaria a mensagem, mas a maioria das execuções não encontra nada e consome cota de uso mesmo assim.

Este guia conecta o Grok Bot ao Deskwoot, define as regras dele com 5 perguntas e deixa um webhook acordar o Grok só quando há trabalho.

Antes de começar

  • Um Grok Bot só seu, mais o app do Grok Bot num computador. Você precisa do computador uma vez, para copiar o endereço de webhook da rotina, porque o app do celular ainda não mostra esse endereço (uma limitação conhecida no fórum do Grok Bot).
  • Um workspace do Deskwoot no Startup, Business ou Enterprise, ou no teste de 7 dias.
  • O proprietário do workspace para fazer a configuração. Quando um administrador ou um membro conecta o Grok, ele fica inativo até o proprietário aprovar.
  • De preferência, um Grok Bot que faça só suporte e mais nada, numa conta da empresa. A seção sobre o que o Deskwoot não consegue controlar explica por quê.

Como funcionam os conectores personalizados no Grok

Um conector personalizado dá ao Grok acesso a um serviço que não está no catálogo dele, por meio do Model Context Protocol (MCP). Ele só funciona enquanto o Grok está rodando: o Grok chama as ferramentas do servidor, e o servidor não consegue iniciar o Grok.

A parte do Grok neste guia funciona do mesmo jeito para outros servidores MCP.

No chat do Grok

Para o chat do Grok em grok.com, a documentação de conectores da xAI descreve estes passos:

  1. Abra Connectors.
  2. Clique em New Connector e depois em Custom.
  3. Informe o endereço do servidor e conclua o login dele.

Depois, o Grok descobre as ferramentas que o servidor oferece. O servidor precisa estar acessível na internet pública.

No Grok Business e no Enterprise, um admin da equipe precisa adicionar o conector no console da xAI antes que os membros possam usá-lo (gerenciamento de conectores).

No Grok Bot

O Grok Bot não tem formulário para isso. Você pede ao bot, no chat dele, que adicione o servidor MCP, e ele confirma os detalhes e faz a configuração, como explica uma resposta no fórum do Grok Bot.

Aqui o servidor também precisa ser público, porque o bot roda na nuvem.

Chave de API ou OAuth

O jeito como o servidor autentica o Grok faz diferença. Alguns servidores pedem uma chave de API colada no Grok.

O Deskwoot usa OAuth: o Grok abre a página de login do próprio Deskwoot, você aprova a conexão ali com a sua senha e não há chave nenhuma para copiar. Se depois você parar o agente no Deskwoot, ele perde o login na hora.

Passo 1: Adicione o Deskwoot como conector personalizado

  1. No Deskwoot, abra Colegas de IA e escolha Conectar um agente de IA. Na primeira vez, um administrador aceita o Acordo de Processamento de Dados para agentes de IA. Escolha Grok Bot como plataforma.
  2. No chat do Grok Bot, peça que ele adicione o Deskwoot como servidor MCP personalizado: Adicione este servidor MCP: https://deskwoot.com/api/mcp. O Grok confirma os detalhes e abre o login do Deskwoot.
  3. Entre com o seu login do Deskwoot se a página pedir, e escolha o workspace em que o Grok deve trabalhar.
  4. Faça suas escolhas na página de consentimento, marque a declaração, digite a sua senha (e o código do app autenticador, se o seu workspace usar um) e clique em Conectar.

O que escolher na página de consentimento

Para uma primeira configuração, recomendamos estas escolhas:

  • "Como um colega de IA próprio (recomendado)". O Grok ganha um nome próprio na sua equipe, e os clientes veem esse nome nas respostas dele.
  • "Só rascunhos" para o que o Grok pode enviar. "Respostas sobre assuntos do dia a dia" e "Todas as respostas" podem vir depois, quando você já confiar nos rascunhos.
  • Suas caixas de entrada, com "Lê todas as conversas das suas caixas de entrada" desligado. Assim o Grok lê só o próprio trabalho: conversas atribuídas ou passadas para ele ou para a equipe dele, e aquelas em que alguém o menciona.
  • "Consultar pedidos e propor reembolsos" também desligado. Mesmo quando está ligado, quem faz cada reembolso é uma pessoa.

A pergunta sobre o que o Grok pode enviar e as duas chaves só aparecem se você já tiver feito login no Deskwoot nesse navegador. Se fizer login na página de consentimento, o Grok começa só com rascunhos, lê só o próprio trabalho, e reembolsos, cancelamentos e outras ações com dinheiro ficam desligados. Um administrador pode mudar isso depois na página do Grok em Colegas de IA.

Passo 2: Responda às 5 perguntas de configuração

Assim que o Grok estiver conectado, o Deskwoot mostra uma frase para você copiar no chat do Grok:

Use o conector do Deskwoot: chame onboarding_start e faça o onboarding comigo.

Depois o Grok faz 5 perguntas, uma de cada vez, com opções para tocar ou espaço para responder com as suas palavras:

  1. Quanto devo assumir? (Só organizar conversas e deixar notas, também preparar respostas como rascunhos ou também responder aos clientes por conta própria.)
  2. Quais outros temas devem esperar por uma pessoa? (Cobrança, questões jurídicas e reclamações, segurança da conta e proteção de dados esperam desde o início.)
  3. Em que tom devo escrever?
  4. Quem assume quando eu escalo uma conversa?
  5. O que eu nunca posso prometer?

Como responder

Escolha "Também preparar respostas como rascunhos" como primeiro trabalho, mesmo que o Grok vá responder aos clientes mais tarde. Cada rascunho que você corrige mostra uma lacuna nas instruções dele antes que um cliente a veja.

Nos temas que esperam por uma pessoa, acrescente aqueles em que uma resposta errada custa dinheiro, como prazos de entrega, devoluções ou descontos.

Para as escalações, indique a pessoa que de fato cuida desses casos, porque "a equipe toda" muitas vezes significa ninguém.

Aprove as regras

A partir das suas respostas, o Grok propõe as regras dele. Elas ficam esperando na página do Grok em Colegas de IA até uma pessoa aprová-las, e até lá o Grok só escreve rascunhos, seja qual for a sua escolha na página de consentimento.

Você também pode pular as perguntas e clicar em "Entrar no ar com estas regras" para começar com as regras padrão.

Passo 3: Deixe o trabalho novo acordar o Grok

Mesmo conectado e com o onboarding feito, o Grok não faz nada até que algo o inicie. O Grok Bot cuida do trabalho sem supervisão por meio de rotinas.

Segundo a documentação da xAI sobre rotinas, uma rotina começa por agendamento, por um evento de apps como Slack ou GitHub, por um e-mail ou por um webhook.

Por que um agendamento custa mais

O agendamento é a escolha óbvia, e também a cara. A mesma documentação diz que "os agendamentos de rotinas precisam ter pelo menos cinco minutos de intervalo", o que ainda dá 288 execuções por dia.

Ela também diz que cada execução consome cota de uso e avisa que um intervalo curto pode gastar num só dia a cota de uma semana. A maioria dessas execuções encontraria a fila vazia.

Rotina a cada 10 minutosRotina de webhook
Execuções num dia sem trabalho novo1440
Quando o Grok começa num chat passado para elena próxima execução, até 10 minutos depoisquando o Deskwoot o acorda

Configure a rotina de webhook

Quando terminar as perguntas, escreva isto ao Grok:

Use o conector do Deskwoot: chame whoami e configure a rotina do Deskwoot com um gatilho de webhook.

O Grok cria a rotina com uma instrução que o Deskwoot entrega a ele (trabalhar as conversas em espera uma de cada vez e depois parar), então você não escreve nenhuma. Depois, copie o endereço e a chave da rotina:

  1. Abra o Grok Bot no seu computador, clique no nome do bot no topo e depois em Details.
  2. Em Routines, clique na rotina do Deskwoot e procure a seção Webhook dela.
  3. Copie "POST to" e "Key". Ignore "Header", que é a mesma chave com "Authorization: Bearer" na frente.
  4. No Deskwoot, cole os dois no último passo de Conectar um agente de IA, ou depois na página do Grok em Colegas de IA, em "Acordar o Grok Bot na hora".

O que acorda o Grok

A partir daí, o Deskwoot acorda o Grok quando:

  • o Fynn ou uma pessoa passa uma conversa para ele, ou uma das equipes dele recebe uma
  • um cliente escreve numa conversa em que o Grok está trabalhando
  • alguém menciona o Grok numa nota privada
  • uma das respostas do Grok não chegou ao cliente

O sinal que acorda o Grok leva só o ID da conversa e nenhum texto do cliente. O Grok lê a conversa pelo conector, com as mesmas regras de leitura de antes.

O Deskwoot também envia um sinal de cada vez, então um cliente que manda 4 mensagens curtas seguidas inicia uma única execução.

Se o despertar falhar

A página do Grok no Deskwoot mostra se o último despertar funcionou. Se falhou, confira se:

  • a rotina está ligada no Grok
  • o endereço e a chave batem com a tela Webhook da rotina
  • o Deskwoot ainda é um dos conectores do Grok

A xAI também observa que o Grok Bot "pode perguntar se deve manter as rotinas rodando depois de um longo período de ausência, e pausá-las se não houver resposta". Por isso, na volta das férias, olhe primeiro a rotina.

Se preferir não usar o webhook, uma rotina a cada 10 minutos com a mesma instrução também funciona, só que mais devagar.

Passo 4: Deixe o Fynn passar chats ao vivo para o Grok

O Fynn, o agente de IA que já vem no Deskwoot, responde no chat ao vivo no momento em que o cliente escreve. O Grok trabalha mais como um colega que pega o que passam para ele.

Quando o conhecimento do Fynn acaba ou só alguém da equipe pode agir, o Fynn passa a conversa adiante. A configuração de bot da caixa de entrada "O bot passa as conversas para" decide para onde ela vai: para a sua equipe ou para o Grok.

O Grok só recebe uma conversa passada adiante enquanto estiver presente e autorizado naquela caixa de entrada. Caso contrário, quem recebe é a sua equipe. Um cliente que pede uma pessoa sempre vai para uma pessoa.

Como o Grok só assume um chat ao vivo depois de uma transferência, o cliente nunca recebe respostas de 2 bots ao mesmo tempo. A parte do Fynn está em Configurar o bot de IA do Deskwoot (Fynn).

Teste antes que um cliente teste

  1. De uma conta pessoal, escreva para o seu próprio chat ao vivo ou endereço de suporte e pergunte algo que a sua central de ajuda não cobre, ou atribua você mesmo a conversa ao Grok.
  2. Acompanhe o status do despertar na página do Grok: primeiro o Deskwoot acordou o Grok, depois o último despertar funcionou.
  3. Abra a conversa. Enquanto o Grok só escreve rascunhos, a resposta dele espera na pasta "Aguardando aprovação", com Aprovar, Editar e Rejeitar.

O próprio conselho da xAI para rotinas é "exigir aprovação para enviar", e é assim que faríamos nos primeiros dias.

Se ninguém decidir sobre um rascunho, seus administradores recebem um lembrete depois de 4 horas, e ele expira depois de 24. Aí a conversa vai para a sua equipe. Quando os rascunhos raramente precisarem de ajustes, suba o nível do Grok na página dele.

Começando pelo X com @bot

Você também pode marcar o @bot num post no X e pedir que ele adicione o Deskwoot como servidor MCP para o seu suporte. O seu Grok Bot principal recebe o post como uma tarefa e, segundo a documentação do @bot da xAI, o trabalho e os resultados ficam na conversa desse Bot no app do Grok Bot. É ali que você conclui o login no Deskwoot, como no passo 1. Marque o @bot, não o @grok: um post que marca o @grok não é processado.

É novo no Deskwoot? Escolha "Criar conta" na página de login, e o seu workspace começa com o teste de 7 dias. A página de login não recebe ela mesma o Acordo de Processamento de Dados. Abra o Deskwoot no seu próprio navegador, aceite o acordo no primeiro passo de "Conectar um agente de IA" em Colegas de IA e depois recarregue a página de login ou peça ao Grok para se conectar de novo.

Quando você faz login ou cria a sua conta nessa página, a conexão começa só com rascunhos e lê só o próprio trabalho. Um administrador pode mudar isso depois em Colegas de IA.

Países onde marcar o bot ainda não funciona

A documentação do @bot da xAI diz que marcar o bot ainda não está disponível para contas do X sediadas na Austrália, no Reino Unido, na União Europeia, na Islândia, em Liechtenstein ou na Noruega.

O X considera o país registrado na sua conta, e uma conta que só tem uma região ou nenhum país registrado também fica de fora por enquanto. Nesses países, você começa do mesmo jeito no app do Grok Bot.

Quanto custa

O Deskwoot não cobra mensalidade pelo Grok nem por nenhum outro agente de IA que você conecta por MCP. Cada conversa em que uma resposta do Grok chega ao cliente conta como 1 conversa de IA por janela (72 horas para um e-mail ou um ticket, 12 horas sem mensagens para um chat), da mesma franquia do Fynn e do Copilot e além deles:

  • 50 conversas de IA por mês incluídas no Startup, depois US$ 0,07 por conversa a mais
  • 100 por mês incluídas no Business, depois US$ 0,05 por conversa a mais
  • 300 por mês incluídas no Enterprise, depois US$ 0,03 por conversa a mais

As conversas de IA a mais são pagas com o seu saldo pré-pago. O outro trabalho do Grok numa conversa, como uma nota, uma etiqueta ou um rascunho para uma pessoa, conta 0,5: um rascunho do Grok que uma pessoa aprova conta 0,5, e uma resposta posterior do Grok na mesma janela soma o outro 0,5. O Grok e os seus outros agentes juntos contam no máximo 1 por janela, e junto com o Fynn eles somam no máximo 0,5, então se o Fynn responde e passa a conversa para o Grok, que responde, a janela conta 1,5. Ler conversas nunca conta, nem uma mensagem que uma pessoa escreve e envia.

No Startup, no Business, no Enterprise e no teste de 7 dias, você conecta quantos agentes de IA quiser. Quando as conversas de IA acabam e o saldo pré-pago não cobre mais uma, uma resposta do Grok que ainda somaria à contagem espera como rascunho por uma pessoa. O plano gratuito Hacker não tem agentes de IA. A página de preços mostra todos os planos.

A parte do Grok na conta

Cada janela de uma conversa em que a resposta do Grok chega ao cliente usa 1 das suas conversas de IA do Deskwoot, ou 0,5 quando o Grok só trabalhou nela, como num rascunho que uma pessoa aprovou, além do que o Fynn usa ali, como explicado acima. Além disso, as conversas em que ele trabalha contam para o limite mensal de conversas do seu plano.

O próprio Grok Bot é cobrado à parte, pela xAI, pelo X ou pelo Cursor, conforme o plano que dá a você acesso a ele (perguntas frequentes da xAI sobre o Grok Bot). Com uma rotina de webhook, a cota de uso dele vai para execuções que têm trabalho.

O que o Deskwoot não consegue controlar

Para onde vão os dados

Tudo o que o Grok lê no Deskwoot sai do Deskwoot. Vai para a xAI, para o Cursor e para qualquer ferramenta a que o Grok repasse esses dados. A documentação da xAI sobre segurança e privacidade diz que o Grok Bot usa o login e as configurações de dados da conta do Cursor.

O Deskwoot hospeda os dados do seu workspace na UE e nunca os usa para treinar modelos de IA. Se a xAI ou o Cursor fazem isso depende dos termos deles e das configurações da sua conta.

A sua empresa precisa de um acordo próprio para esses dados com quem fornece o seu Grok Bot.

Instruções escondidas em mensagens de clientes

Dentro do Deskwoot, as mensagens dos clientes chegam ao Grok marcadas como não confiáveis, e respostas arriscadas esperam por uma pessoa, não importa o que tenham dito ao Grok.

O que o Deskwoot não consegue impedir é que o Grok siga instruções escondidas numa mensagem de cliente quando age fora do Deskwoot, por outros conectores como Gmail ou Slack. Por isso, rode o suporte num Grok Bot só para isso e deixe a caixa de e-mail de suporte fora dos conectores dele.

As regras que todo colega de IA segue estão em como deixar um agente de IA agir de verdade sem perder o controle.

O dia a dia do Grok numa equipe está no nosso post de lançamento do Grok Bot, e a configuração para outros clientes MCP em Conecte um agente de IA com o servidor MCP.

Experimente com uma conversa de teste

Configurado assim, o Grok só começa quando uma conversa precisa dele, e as respostas dele esperam por uma pessoa até você subir o nível dele. A cota de uso dele vai para execuções que têm trabalho.

Você não cola nenhuma chave de API nem escreve instrução de rotina. Dá para conferir o resultado você mesmo: o status do despertar fica na página do Grok, e o rascunho da sua mensagem de teste espera em "Aguardando aprovação".

Para fazer esse teste, cadastre-se em deskwoot.com/pt-BR/signup, abra Colegas de IA, escolha Conectar um agente de IA e selecione Grok Bot.

Todo workspace novo ganha 7 dias de Enterprise sem cartão, para até 30 assentos, incluindo o seu, e o Grok também funciona no teste.

Quando o teste termina, você escolhe um plano pago ou continua trabalhando no plano gratuito Hacker, com 1 assento. Esse plano não tem agentes de IA, então aí o Grok precisa de um plano pago.

Também disponível em:EnglishDeutschEspañolFrançais

PERGUNTAS

Perguntas frequentes

Como adiciono um conector MCP personalizado ao Grok?

No chat do Grok em grok.com, segundo a documentação da xAI, você abre Connectors, clica em New Connector e depois em Custom, informa o endereço do servidor e conclui o login dele. No Grok Business e no Enterprise, um admin da equipe adiciona o conector antes. O Grok Bot não tem formulário para isso: você pede ao bot, no chat dele, que adicione o servidor MCP, e ele confirma os detalhes e faz a configuração. Nos dois casos, o servidor precisa estar acessível na internet pública.

Preciso de uma chave de API para conectar o Grok Bot ao Deskwoot?

Não. Você pede ao Grok Bot que adicione https://deskwoot.com/api/mcp como servidor MCP personalizado, e o Grok abre o login do Deskwoot. Lá você escolhe o que o Grok pode fazer e confirma com a sua senha, então não há token nenhum para copiar.

Um webhook pode iniciar uma rotina do Grok Bot?

Sim. Peça ao Bot que adicione um gatilho de webhook, depois abra a rotina no app do Grok Bot para computador e copie o endereço em "POST to" e a chave. Um POST para esse endereço com a chave como bearer token inicia uma execução, e uma resposta 200 significa que a execução começou.

Com que frequência uma rotina do Grok Bot pode rodar por agendamento?

A documentação da xAI diz que os agendamentos de rotinas precisam ter pelo menos 5 minutos de intervalo. Cada execução consome cota de uso, então intervalos curtos pesam: a cada 5 minutos são 288 execuções por dia, e num dia tranquilo a maioria delas não encontra nada. Uma rotina de webhook só roda quando algo a chama.

Por que a minha rotina de webhook do Grok Bot não inicia?

A ajuda do Grok Bot diz que qualquer resposta diferente de 200 significa que nenhuma execução começou, e aponta como causa uma rotina pausada ou uma chave desatualizada. O Grok Bot também pode pausar rotinas depois de um longo período de ausência, se ninguém responder à pergunta dele. No Deskwoot, a página do Grok mostra quando o último despertar falhou e o que conferir.

Quanto custa conectar o Grok Bot ao Deskwoot?

O Deskwoot não cobra mensalidade por um agente de IA conectado, e você pode conectar quantos quiser. Cada conversa em que a resposta do Grok chega ao cliente conta como 1 conversa de IA, uma vez por janela (72 horas para um e-mail ou um ticket, 12 horas sem mensagens para um chat) e além do Fynn, somando no máximo 0,5 junto com ele. O outro trabalho do Grok, como uma nota ou um rascunho que uma pessoa aprova, conta 0,5 até que uma resposta posterior do Grok na mesma janela some o outro 0,5. Os planos incluem 50 (Startup), 100 (Business) ou 300 (Enterprise) por mês, e cada conversa a mais custa US$ 0,07, US$ 0,05 ou US$ 0,03 do seu saldo pré-pago. O próprio Grok Bot é cobrado à parte, pela xAI, pelo X ou pelo Cursor, conforme o plano que dá acesso a ele.

Blog

Ver todos os artigos

Terminou de ler?
Teste com a sua equipe.

Teste grátisJunte seus canais em uma só caixa de entrada e deixe o Fynn responder às perguntas de rotina. Grátis por 7 dias, sem cartão de crédito.

Demo interativa do Deskwoot