Como criar um agente de WhatsApp com o OpenAI Agents SDK

O OpenAI Agents SDK é o framework de código aberto da OpenAI para criar agentes: um modelo com instruções, ferramentas que ele pode chamar, handoffs para outros agentes e guardrails em torno das suas entradas e saídas, tudo executado em um ciclo até a tarefa terminar. É uma ótima forma de criar um agente. Mas, por si só, ele não oferece um número de WhatsApp, uma caixa de entrada da equipe, mensagens de template nem uma forma de uma pessoa assumir a conversa. Com o Agent Harness da MonoChat, você escolhe o OpenAI Agents SDK como um Harness de IA, coloca um nó de Agente de IA em um fluxo, conecta o WhatsApp e testa, e a MonoChat cuida do resto.

Este guia cobre o que o SDK oferece, as três formas de usar agentes da OpenAI na MonoChat, uma configuração passo a passo e os detalhes específicos do WhatsApp que decidem se os clientes confiam no agente.

O que o OpenAI Agents SDK oferece

O SDK é construído em torno de um pequeno conjunto de ideias:

• Agentes: um modelo mais instruções que descrevem sua função.
• Ferramentas: funções que o agente pode chamar, como “consultar um pedido” ou “verificar um horário”, além de servidores MCP.
• Handoffs: um agente passando a tarefa a outro especializado nela, por exemplo de um agente de suporte geral para um agente de devoluções.
• Guardrails: verificações executadas junto ao agente para barrar entradas ou saídas indesejadas.
• Sessões e tracing: memória entre as interações e um registro do que o agente fez, passo a passo.

Juntos, isso é um agent harness: o ciclo que permite a um modelo agir, verificar o próprio trabalho e continuar, em vez de responder uma única vez. No atendimento por mensagens, essa é a diferença entre explicar sua política de devolução e de fato criar a devolução.

O que o WhatsApp acrescenta ao problema

Criar o agente é metade do trabalho. Colocá-lo diante dos clientes no WhatsApp exige lidar com:

• A WhatsApp Business Platform. Uma conexão oficial de API, uma empresa verificada e um número aprovado.
• A janela de 24 horas. Respostas livres são permitidas dentro de 24 horas após a última mensagem do cliente; depois disso, você precisa de um template aprovado.
• A política. Desde 15 de janeiro de 2026, o WhatsApp mantém assistentes de IA de uso geral fora da plataforma. Um agente que atende os seus próprios clientes é permitido, e espera-se um caminho claro até uma pessoa quando as respostas são automatizadas.
• As pessoas. Algumas conversas precisam ir para uma pessoa, com o histórico preservado, dentro da ferramenta que sua equipe já usa.
• Outros canais. Clientes que escrevem no Instagram, no Messenger ou no seu site esperam as mesmas respostas.

A MonoChat cuida disso ao redor do agente, para que o seu trabalho fique no agente em si.

Três formas de usar agentes da OpenAI na MonoChat

Opção	Onde é executado	O que você precisa
OpenAI Agents SDK	Dentro da MonoChat	Nada extra; usa seus modelos de IA
OpenAI Agents API (hospedada pela OpenAI)	Nuvem da OpenAI	Sua chave de API da OpenAI
Personalizado (seu próprio serviço do Agents SDK)	Seu próprio servidor	Uma URL de endpoint e um segredo compartilhado

Comece com o harness do OpenAI Agents SDK se quiser um agente no estilo da OpenAI sem implantar nada. Escolha a OpenAI Agents API se seus agentes já vivem na plataforma hospedada da OpenAI. Escolha o Personalizado se seus desenvolvedores escreveram o próprio agente com o SDK, com ferramentas, handoffs e testes próprios, e querem continuar executando esse código; veja como conectar seu próprio agente de IA ao WhatsApp.

Passo a passo: um agente do OpenAI Agents SDK no WhatsApp

1. Adicione um Harness de IA

Adicione um Harness de IA na MonoChat e escolha OpenAI Agents SDK como provedor. Ele é executado dentro da MonoChat e usa os modelos de IA que você já configurou, então não há chaves nem servidores extras nesta etapa.

2. Adicione um nó de Agente de IA a um fluxo

No fluxo que recebe suas conversas de WhatsApp, adicione um nó de Agente de IA e selecione o harness. Escreva as instruções do agente: quem ele atende, o que pode fazer, o que nunca deve fazer e quando transfere a conversa.

3. Escolha os modelos principal, de fallback e rápido

Todo nó de Agente de IA tem três funções de modelo:

• O modelo principal raciocina e escreve as respostas.
• O modelo de fallback assume após um limite flexível ou uma falha.
• O modelo rápido cuida do trabalho em segundo plano.

Adicione um limite de orçamento por execução para que uma conversa incomum não gere uma conta alta. Não sabe como escolher o fallback? Leia por que o seu agente de IA que atende clientes precisa de um modelo de fallback.

4. Conecte suas ferramentas

Dê ao agente as ferramentas que correspondem às suas solicitações mais frequentes:

• Ferramentas de função de IA para chamadas às suas próprias APIs com entradas estruturadas.
• Integração com MCP para ferramentas de sistemas compatíveis com MCP.
• A base de conhecimento com IA para respostas baseadas nos seus documentos e políticas.
• Funções personalizadas para lógica executada dentro da conversa.

Três boas ferramentas valem mais do que quinze testadas pela metade. Adicione mais quando vir conversas reais.

5. Conecte o WhatsApp (e todo o resto)

Conecte seu número do WhatsApp Business pela MonoChat, Meta Business Partner oficial. O mesmo fluxo pode rodar no Instagram, no Messenger, no TikTok, no Telegram, no chat web, no SMS e por voz, então um só agente cobre todos os canais.

6. Teste com mensagens reais

Use as conversas do mês passado como seu conjunto de testes. Inclua as difíceis: clientes irritados, perguntas vagas, vários pedidos em uma só mensagem, um cliente que pede uma pessoa logo de cara. Verifique as chamadas de ferramentas, o tom e a transferência. Depois entre no ar.

Padrões que funcionam bem no WhatsApp

Uma pergunta por mensagem. Agentes criados para chat na web tendem a responder com listas longas. No celular, mensagens curtas e uma pergunta clara por vez geram respostas melhores dos clientes.

Confirme antes de ações irreversíveis. Deixe o agente propor e o cliente confirmar antes de um cancelamento, um reembolso ou uma alteração de reserva.

Especialistas por handoffs, pessoas pela caixa de entrada. Os handoffs do SDK são ótimos para rotear entre agentes (vendas, suporte, devoluções). A transferência para uma pessoa pertence à caixa de entrada compartilhada da equipe da MonoChat, onde a conversa chega com todo o histórico.

Instruções que nomeiam os limites. “Reembolsos de até €50 você pode aprovar; acima disso, passe para a equipe de cobrança.” Números explícitos valem mais do que regras vagas.

Mantenha o foco no seu negócio. Um agente que ajuda seus clientes é permitido no WhatsApp. Um que responde a qualquer coisa corre o risco de violar as regras do WhatsApp de 2026; nosso guia da política de chatbots de IA do WhatsApp explica onde fica a linha.

Custos

Três coisas se somam: seu plano da MonoChat, o uso dos modelos de IA e as tarifas de mensagens do WhatsApp da Meta. Desde 1º de outubro de 2026, a Meta cobra as respostas de atendimento depois das primeiras 1.000 por número comercial a cada mês; veja nosso guia de preços da API do WhatsApp.

Do lado da IA, a MonoChat não acrescenta nenhum valor quando você usa as chaves dos seus próprios provedores. Orçamentos por execução, um modelo rápido mais barato para o trabalho em segundo plano e um fallback confiável mantêm a conta previsível.

Sem ficar preso a um fornecedor

O Agent Harness permite escolher o framework, não apenas o modelo. Se mais tarde você quiser experimentar o Claude Agent SDK, o Pi, o Claude Managed Agents ou o seu próprio framework, adicione outro Harness de IA e aponte o nó de Agente de IA para ele. Seus canais, ferramentas e transferência continuam como estão. Compare todos os provedores na página do Agent Harness.