Rotinas do Grok Bot: como agendar um Bot, acioná-lo por webhook e corrigir problemas

O que é uma rotina do Grok Bot

Nas palavras da xAI, uma rotina “diz a um Bot quando rodar um workflow: com agendamento ou quando algo acontece.” Ela pertence a um Bot, usa a memória e as skills desse Bot e publica os resultados no chat dele.

• Agendamentos: frases simples como “every weekday at 8:00 AM” ou “every 2 hours”, no fuso horário definido em Settings.
• Eventos: um gatilho do Slack; um evento do GitHub, Linear, Sentry ou PagerDuty; um e-mail para o endereço próprio do Bot; ou uma chamada de webhook.
• Uma rotina nova não roda quando você a cria. Ela espera o próximo horário agendado; use Test para rodá-la agora.
• As rotinas rodam no computador do Bot na nuvem, então continuam quando o seu notebook está fechado.
• Toda execução, inclusive os testes, consome o seu uso do Grok Bot.

Como criar uma rotina no Grok Bot

1. Peça ao Bot que deve cuidar do trabalho

   No desktop, abra o chat desse Bot e descreva o trabalho e quando ele deve rodar. Diga de onde vem a entrada, que resultado você quer, o que precisa da sua aprovação e o que fazer se uma fonte estiver faltando. No celular, abra o perfil do Bot, toque em Add routine em Routines e complete a mensagem que começa com “Set up a routine to”.

   # Peça ao Bot que deve cuidar do trabalho, no chat dele
   Crie uma rotina para organizar o meu Gmail da noite todo dia útil às 7:00,
   rascunhar respostas para o que for urgente e me mandar a lista. Não envie nada.
   
   Crie uma rotina todo domingo às 18:00: revise o Google Calendar da próxima semana,
   aponte conflitos e dias sobrecarregados e me mande um plano para segunda.
   
   Crie uma rotina a cada 2 horas nos dias úteis: confira o canal #launch do Slack
   em busca de perguntas sobre preços e rascunhe respostas para eu aprovar.

2. Confira “When to run” e o fuso horário

   Abra a rotina e leia When to run para confirmar o agendamento salvo; se estiver errado, escolha Edit e descreva a correção. O fuso horário fica em Settings, em Bot, no campo Timezone. O Auto-detect usa o fuso do seu computador, então escolha um fixo se o trabalho pertence a outro lugar.

3. Teste uma vez

   No desktop, abra a rotina e escolha Test. Ela mostra Running… até a execução terminar, e o resultado aparece no chat do Bot. Os testes fazem trabalho de verdade, como alterar arquivos ou usar sites, então mantenha tudo o que grava ou envia atrás da sua aprovação. Se uma rotina não tiver botão Test, peça ao Bot para fazer o trabalho uma vez no chat com uma entrada segura.

4. Pause, retome ou exclua

   No desktop, clique no nome do Bot, abra Details e use a chave na linha da rotina, ou abra a rotina e escolha Pause ou Resume. No celular, abra a rotina pelo perfil do Bot e desligue Active; deslize a linha para excluí-la. A exclusão não pode ser desfeita.

Fonte: documentação do Grok Bot da xAI, Skills and routines

Como acionar uma rotina com um webhook

Um webhook deixa outro serviço iniciar uma rotina, por exemplo a sua loja quando um reembolso é pedido, ou um formulário quando alguém se cadastra.

1. Adicione o gatilho

   Peça ao Bot para adicionar um gatilho de webhook à rotina.

2. Copie a URL e a chave

   No desktop, abra a rotina e encontre a seção Webhook: POST to (a URL), key (o segredo) e header (o cabeçalho Authorization completo). Clique em um campo para copiá-lo.

   # Copie "POST to" e "key" da seção Webhook da rotina (desktop)
   curl -X POST "https://<POST to URL from the routine>" \
     -H "Authorization: Bearer <key>" \
     -H "Content-Type: application/json" \
     -d '{"order": "1042", "status": "refund requested"}'
   
   # 200 = uma execução começou (veja o resultado no chat do Bot)
   # qualquer outra resposta = nenhuma execução começou

3. Envie um POST e leia a resposta

   Envie um HTTP POST com a chave como Authorization: Bearer <key>. Você pode incluir um corpo JSON; o Bot o recebe junto com as instruções da rotina. Um 200 significa que uma execução começou, não que terminou. Qualquer outra resposta significa que nenhuma execução começou: confira se a rotina não está pausada e se você está usando a chave atual.

Gatilhos do Slack, GitHub e outros eventos

• Slack: dispara quando o Bot é mencionado, quando uma palavra ou frase aparece, quando alguém reage a uma mensagem ou em qualquer mensagem, em um canal ou em todo o Slack. Conecte o Slack antes na conta do Cursor dona do Bot.
• GitHub, Linear, Sentry e PagerDuty: iniciam uma rotina a partir de um evento nessas ferramentas; esses gatilhos passam pelas integrações da conta do Cursor e podem exigir conexão própria.
• E-mail: uma rotina pode começar a partir de um e-mail enviado ao endereço próprio do Bot.
• Só atividade nova inicia uma execução. Mantenha os gatilhos estreitos: um canal movimentado observado em toda mensagem consome uso rápido.

Limites das rotinas do Grok Bot

Rotinas do Grok Bot não funcionam? O que conferir

• Nunca rodou: uma rotina nova espera o próximo horário agendado. Escolha Test para rodá-la agora.
• Está pausada: no desktop a chave da linha está desligada; no celular, Active está desligado. O Grok Bot também pode pausar rotinas sozinho depois que você ficou ausente.
• Horário errado: leia When to run e depois confira o Timezone em Settings > Bot. O Auto-detect segue o computador em que você está.
• Um gatilho do Slack não disparou: a mensagem precisa ser nova, estar no canal observado e conter a frase correspondente.
• O webhook não iniciou uma execução: qualquer resposta diferente de 200 significa que não iniciou. Confira se a rotina não está pausada e se a chave é a atual.
• Uma execução falhou por limite de taxa: estreite o gatilho ou espace o agendamento, depois rode de novo com Test ou reenviando o webhook. A xAI também lista falhas causadas por um limite compartilhado do Grok Bot como problema conhecido; essas não são repetidas automaticamente.
• O uso acabou: toda execução consome o seu uso semanal. Pause as rotinas de que você não precisa e espace os agendamentos. Na The X Subscription, o uso extra vem de crédito pré-pago; nos planos antigos do Cursor, do uso sob demanda, se estiver ativado.
• “Sync failed”: a documentação de rotinas da xAI não descreve esse erro. Abra a rotina, confira o agendamento e o gatilho e rode Test; se continuar falhando, fale com o suporte do Grok Bot pelo app.

Ideias de rotina a partir dos próprios exemplos da xAI

Estas vêm dos casos de uso da documentação da xAI; cada uma rascunha o trabalho e espera a sua aprovação antes de qualquer coisa sair.

Rotinas também para o seu agente de código

As rotinas do Grok Bot servem para trabalho que vive no Gmail, no Slack e no Notion. Se o trabalho vive em um repositório de código, o Crewmark dá o mesmo ritmo ao seu próprio Claude Code ou Codex: um funcionário de IA com um cargo, uma meta em números, horário de trabalho e um heartbeat que o acorda para pegar a próxima issue de um quadro.

1. Contrate um funcionário no seu agente

   Rode o comando de configuração em uma conversa do Claude Code ou do Codex; essa conversa vira o funcionário. Veja o que é um funcionário de IA.

2. Defina horário e um heartbeat

   Ele acorda a cada 15 a 240 minutos durante o horário que você escolher, inclusive de madrugada. Veja como deixar o Claude Code proativo e tarefas agendadas no Codex.

3. Compare agentes pessoais

   Veja o guia do Grok Bot e agentes pessoais de IA comparados.

Perguntas frequentes