flow api
Guide

Crie um bot do Grok para WhatsApp

Os bots do Grok estão em alta. Veja como colocar um no WhatsApp, onde seus clientes já estão: ele lê cada mensagem recebida, pede ao Grok uma resposta no tom do seu negócio e responde pelo seu próprio número.

Video walkthrough: Crie um bot do Grok para WhatsApp · 37 seconds · click the bar to jump to a step

Do que você precisa

  • Um número da Flow API conectado ao WhatsApp (teste grátis de 7 dias)
  • Uma chave de API da xAI em console.x.ai
  • n8n, ou um pequeno servidor que receba um webhook

O mais rápido: resposta automática com IA integrada

Sem n8n e sem servidor. No console da Flow API, abra seu número → Resposta automática com IA, escolha o Grok, cole sua chave da xAI, escreva as instruções e ative. Cada mensagem recebida desperta o bot: ele lê a conversa recente, mostra «digitando…» e responde. Quando você responde num chat, o bot fica em silêncio nele por 30 minutos.

Opção A: sem código, com n8n

  1. 1Adicione um Flow API Trigger (nó da comunidade n8n-nodes-flowapi) no modo Incoming Message. Ao ativar o fluxo, o webhook é configurado sozinho.
  2. 2Adicione um nó AI Agent com o modelo xAI Grok Chat Model e sua chave da xAI.
  3. 3Na mensagem de sistema do agente, descreva seu negócio, horários e tom, e diga quando passar a conversa para uma pessoa.
  4. 4Adicione um nó Flow API: Send Text Message para {{ $json.chatId }} com a resposta do agente.
  5. 5Ative e mande uma mensagem para o seu número de outro celular.

Opção B: 30 linhas de Python

No console da Flow API, defina a Webhook URL do seu número como o endereço /whatsapp deste servidor e rode:

import os, requests
from flask import Flask, request

app = Flask(__name__)
SEND = "https://flowapi.pro/waInstance{idInstance}/sendMessage/{apiTokenInstance}"
PROMPT = "You are the WhatsApp assistant of Bright Dental Clinic. Answer briefly and kindly."

@app.post("/whatsapp")
def whatsapp():
    n = request.get_json()
    if n.get("typeWebhook") != "incomingMessageReceived":
        return "ok"
    chat = n["senderData"]["chatId"]
    text = n["messageData"].get("textMessageData", {}).get("textMessage", "")
    if not text or chat.endswith("@g.us"):
        return "ok"
    r = requests.post("https://api.x.ai/v1/responses",
        headers={"Authorization": f"Bearer {os.environ['XAI_API_KEY']}"},
        json={"model": "grok-4.3", "input": [
            {"role": "system", "content": PROMPT},
            {"role": "user", "content": text}]}, timeout=60).json()
    reply = next(c["text"] for o in r["output"] if o["type"] == "message"
                 for c in o["content"] if c["type"] == "output_text")
    requests.post(SEND, json={"chatId": chat, "message": reply}, timeout=30)
    return "ok"

Deixe com cara de gente

  • Chame sendTyping antes de responder para o cliente ver «digitando…».
  • Respostas de poucas linhas: WhatsApp é conversa.
  • Dê ao bot uma saída clara: «Alguém da equipe vai responder em instantes» quando ele não tiver certeza.

Deixe o Grok agir, não só responder

Em vez de uma resposta fixa, dê ao Grok o link MCP da Flow API como ferramenta MCP remota. Assim ele pode ler o histórico da conversa, enviar sua tabela de preços em PDF ou criar um grupo com sua equipe, sozinho.

Questions

O bot precisa de aprovação da Meta ou de modelos de mensagem?

Não. A Flow API conecta seu número de WhatsApp atual como dispositivo, então o bot responde com mensagens normais.

Quanto custa?

A Flow API custa US$ 10 por número por mês. O uso do Grok é cobrado pela xAI por tokens.

Try it on your own number

7 days free, no credit card. Then $10 per number per month.

Start free trial

Related