--- description: Saiba mais sobre como a ação Make HTTP requests do Agente de IA permite que seu Agente de IA chame APIs externas durante conversas para recuperar dados em tempo real ou acionar ações em sistemas de terceiros. title: Ação do Agente de IA: Make HTTP requests image: https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F3f43c48b21b24f4e8b02b100c0c8fab0 --- [NovoAcabamos de captar US$ 62,5 milhões na Série B! 🎉 O que isso significa para você![arrow-icon](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2Fe43213a7a9314673bd8d2060c25f9b87)](https://respond.io/blog/respond-io-raises-62-million-series-b) Me ajude com... ⌘ 1. [All Collections >](/pt/help) 2. [ Produto >](/pt/help/product) 3. [ Agentes de IA >](/pt/help/ai-agents) 4. [ Ações do Agente de IA >](/pt/help/ai-skills) 5. Ação do Agente de IA: Make HTTP requests # Ação do Agente de IA: Make HTTP requests > **Elegibilidade do plano:** Disponível nos planos Advanced, Enterprise e em alguns planos Legacy selecionados. O teste está disponível para todos os usuários, mas publicar requer um plano elegível. A ação **Make HTTP requests** permite que seu Agente de IA chame APIs externas durante uma conversa. Isso permite que o Agente de IA recupere dados em tempo real ou execute ações em sistemas externos com base na solicitação do contato. Por exemplo, ele pode verificar o status do pedido, obter informações da conta ou criar registros em outro sistema. Neste artigo, você aprenderá como configurar a ação de solicitação HTTP e testá-la com seu Agente de IA. O Agente de IA: 1. Analisa a mensagem do contato para determinar se ela corresponde à intenção definida nas instruções da sua ação. 2. Coleta as informações necessárias. 3. Envia a solicitação HTTP. 4. Interpreta a resposta da API. 5. Responde naturalmente ao contato. ## Adicionar a ação Make HTTP requests Ative a ação e clique no botão “Add action” para começar a configurar sua solicitação HTTP. ![](https://assets2-proxy.respond.io/ph8r57dk1q9w/1Tbaws3LvA9FysLz9eC0Iv/594d61b1024dfcb48ca704559cc37070/addhttprequest.png?fm=jpg&q=80&w=1200&fl=progressive) ### Defina quando a ação deve ser executada Dê um nome descritivo para a ação no campo **Action name** . No campo **When and how should this action be performed?** descreva: * Quando o Agente de IA deve usar esta ação * O que ele recupera ou envia * Quaisquer condições ou resultados a serem tratados ![](https://assets2-proxy.respond.io/ph8r57dk1q9w/1Ry7D5PA3Efyy2GFykdlYs/88cfe62f2b7c9b0792e81c1bb9d75c45/httprequest1.png?fm=jpg&q=80&w=1200&fl=progressive) Exemplo: ```html Use esta ação para recuperar o status do pedido de um contato quando ele perguntar sobre o pedido. Se a API retornar um erro 404, informe ao contato que o pedido não pôde ser encontrado. ``` O Agente de IA usa essa descrição para decidir quando acionar a solicitação. ### Informações que o Agente de IA pode precisar (opcional) Defina as entradas necessárias nesta seção antes de chamar sua API. São variáveis estruturadas que o Agente de IA deve coletar. A solicitação é acionada somente depois que todas as entradas obrigatórias estiverem disponíveis. Se um valor estiver: * Já mencionado na conversa → o Agente de IA o usa. * Faltando → o Agente de IA solicita essa informação ao Contato. As variáveis criadas aqui podem ser usadas na configuração da API. As variáveis de contato (como $contact.email) estão disponíveis automaticamente e não precisam ser adicionadas. ![](https://assets2-proxy.respond.io/ph8r57dk1q9w/1SOzjJK2pM8p7CorIfIpLw/f4613151ecf044cacd5685035b823b06/httprequest2.png?fm=jpg&q=80&w=1200&fl=progressive) **Configurações do campo** | Campo | Notas | | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Nome | O identificador de variável usado na sua solicitação de API. \- Único por ação\- Letras, números e underscores apenas\- Sensível a maiúsculas/minúsculas\- Máx 30 caracteres Referencie usando: $agent.variable\_name Exemplo: $agent.order\_id | | Formato | Define o tipo de dado esperado: \- Texto (padrão)\- Número\- Booleano\- Data Escolha o formato correto para reduzir ambiguidades e melhorar a confiabilidade. | | Descrição | Explica o que o valor representa e ajuda o Agente de IA a solicitá-lo de forma clara.Exemplo: ID de pedido de 8 dígitos do e-mail de confirmação. | | Array (opcional) | Ative isto para coletar múltiplos valores em vez de um. Cada item segue o formato selecionado.Use isso quando você esperar:\- Vários IDs de produto\- Vários números de rastreamento • Múltiplas seleções | ### Configuração da API Defina como o Agente de IA deve chamar sua API. ![](https://assets2-proxy.respond.io/ph8r57dk1q9w/HXBkfyTj6XeXtOX4FMBNB/fe70bf8f63cdb56cd6025cdeff0a341a/apiconfig1.png?fm=jpg&q=80&w=1200&fl=progressive) Você pode configurar: * Método * URL * Parâmetros de consulta * Cabeçalhos * Corpo JSON (para POST, PUT, PATCH) **Referenciando variáveis** Você pode inserir variáveis na URL, parâmetros, cabeçalhos ou corpo usando $. ![](https://assets2-proxy.respond.io/ph8r57dk1q9w/VJWbtyiJ64nQ175Or2uAd/bd77f2a10db9c58cd207ab2fd4f03873/apiconfig2.png?fm=jpg&q=80&w=1200&fl=progressive) Existem dois tipos: * Variáveis de contato — campos de contato existentes * `$contact.email` * Variáveis do Agente de IA — campos definidos em _Informações que o Agente de IA pode precisar_ * `$agent.order_id` As variáveis são substituídas por valores reais quando a solicitação é executada. Se uma variável obrigatória do Agente de IA estiver faltando, o Agente de IA a solicitará antes de acionar a chamada à API. **Como o Agente de IA lida com as respostas da API** Exemplo de corpo: ```json { "order_id": "$agent.order_id", "email": "$contact.email" } ``` O Agente de IA interpreta automaticamente a resposta JSON da API e gera uma resposta natural. Exemplo de resposta da API: ```json { "status": "shipped", "eta": "2025-12-12" } ``` Resposta do Agente de IA: “Boas notícias! Seu pedido foi enviado e está previsto para chegar em 12 de dezembro de 2025.” **Envio de imagens ou arquivos da resposta da API** Se a resposta da API incluir uma URL válida de imagem ou arquivo (por exemplo, uma planta, uma fatura ou uma foto do produto), o Agente de IA pode enviá-la como um anexo renderizado — o mesmo mecanismo usado para as URLs de Knowledge Source e Instruction. Veja [Enviar arquivos e imagens como anexos](https://respond.io/pt/help/ai-agents/how-to-write-effective-ai-agent-prompts#sending-files-and-images-as-attachments). Isso requer uma instrução explícita que o autorize, por exemplo: ```plain Envie imagem/arquivo como anexo sempre que houver uma URL válida de imagem/arquivo na resposta da API. ``` Sem essa instrução, o Agente de IA usará a URL apenas para compor sua resposta de texto — não a enviará como anexo. ## Testando Você pode testar sua ação de solicitação HTTP no painel **Test AI Agent** antes de publicar. ### Como testar 1. Inicie uma conversa de teste que corresponda às condições da sua ação. ![](https://assets2-proxy.respond.io/ph8r57dk1q9w/78KDUCw0a23kfXjjNmSM3M/6033d09c4ccec2669a0f122442ed54ab/testinghttprequest1.png?fm=jpg&q=80&w=1200&fl=progressive) 2. Quando a intenção for detectada e as entradas necessárias estiverem disponíveis, o Agente de IA executa a solicitação HTTP. 3. Um evento de execução aparece no painel de teste: ![](https://assets2-proxy.respond.io/ph8r57dk1q9w/29SmyR5RSQ4gQ5Z3DpuV3K/4763b778c773d906fcbf2659eecf471d/testinghttprequest2.png?fm=jpg&q=80&w=1200&fl=progressive) 1. **{AI Agent name} executou {Action name}** 2. Respostas 2xx são exibidas como sucesso 3. Todos os outros códigos de status são exibidos como falha 4. Clique no evento para ver: 1. **Response** aba (padrão) — corpo completo da resposta da API 2. **Request** aba — payload completo da requisição cURL 3. Opção de copiar para depuração 5. Após receber a resposta da API, o Agente de IA gera uma resposta com base nos dados retornados. **Notas importantes** * Eventos de execução aparecem **apenas no painel Test AI Agent**. Eles não aparecem na Caixa de entrada nem na Atividade do contato. * Se as entradas obrigatórias estiverem faltando, o Agente de IA as pedirá antes de acionar a solicitação. ## Melhores práticas * Seja preciso na descrição da sua ação. Instruções vagas levam a acionamentos vagos. * Defina claramente as entradas obrigatórias. Se o Agente de IA precisar pedir algo, deixe isso óbvio. * Trate os casos de erro nas suas instruções. * Teste sempre antes de publicar. * Evite duplicar lógica já tratada por Workflows, a menos que seja intencional. ## Limitações * Máximo de 10 ações de solicitação HTTP por Agente de IA. * Máximo por ação: * 20 campos de entrada de dados * 50 parâmetros * 50 cabeçalhos * O Agente de IA determina quando chamar a API com base na sua descrição escrita. Instruções mal escritas podem causar acionamentos inesperados. * O tratamento da resposta da API é automático. Você não pode mapear manualmente os campos de resposta — o Agente de IA interpreta o JSON de forma contextual. * Eventos de execução de solicitações HTTP aparecem apenas no painel Test AI Agent e não na Atividade do contato. * Agentes de IA por voz podem acionar a ação Make HTTP requests. No entanto, a resposta retornada da API não é passada de volta ao Agente de IA por voz para gerar a resposta, o que significa que conversas por voz não podem responder dinamicamente com base no resultado da API. * Se o seu Agente de IA atualizar um campo de contato e também usar esse campo nesta ação no mesmo turno, a solicitação envia o valor antigo (ou vazio, se nunca definido) todas as vezes. Isso acontece independentemente de qual ação for executada primeiro. Se estiver interessado, vote na [solicitação de recurso](https://respond.canny.io/feature-request/p/contact-field-http-request-ensure-http-requests-use-latest-contact-field-values). ## Perguntas Frequentes e Resolução de Problemas ### Posso acionar múltiplos endpoints de API? Sim. Você pode configurar até 10 ações separadas de solicitação HTTP por Agente de IA. ### Posso passar dados do contato para a API? Sim. Use $contact.field\_name na URL, cabeçalhos, parâmetros ou corpo. ### O que acontece se os dados necessários estiverem faltando? O Agente de IA pedirá ao contato as informações faltantes antes de acionar a solicitação. ### O Agente de IA espera pela resposta da API? Sim. O Agente de IA aguarda a resposta, interpreta e responde naturalmente com base nos dados retornados. ### Posso chamar um endpoint de API que exige autenticação OAuth 2.0? Não. HTTP Request não oferece suporte a fluxos de autenticação OAuth 2.0, como consentimento do usuário, troca de código de autorização, atualização de token de acesso ou geração dinâmica de tokens. Você pode usar o HTTP Request com endpoints que aceitam métodos de autenticação simples, como chaves de API ou tokens estáticos adicionados à URL, parâmetros de consulta ou cabeçalhos. Por exemplo, se você estiver chamando um endpoint da API do Google e a solicitação falhar, verifique se esse endpoint requer autenticação OAuth 2.0\. Se for, não é suportado. Se o endpoint oferecer suporte a chaves de API ou tokens estáticos, você pode usar esse método de autenticação na configuração do seu HTTP Request. Compartilhar este artigo [![Telegram](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F44daca77a4844f0c8fd29040ddeba057?width=22)](https://api.whatsapp.com/send?text=https://respond.io/help/ai-skills/ai-skill-make-http-requests)[![Facebook](https://assets1-proxy.respond.io/api/v1/image/assets/11f7a662b80a4675973850b067c01fa5/fff57eeb01160bc604392f519b4f3461ca16f0fa1b6a587b20b142cdf1ad0ba7?placeholderIfAbsent=true&width=22)](https://www.facebook.com/sharer/sharer.php?u=https://respond.io/help/ai-skills/ai-skill-make-http-requests)[![Linkedin](https://assets1-proxy.respond.io/api/v1/image/assets/11f7a662b80a4675973850b067c01fa5/7aaf8d87b5410844d83e06a4ed663e4f551b8c5ef51dbb20a8ff064a1eed9a0f?placeholderIfAbsent=true&width=22)](https://www.linkedin.com/sharing/share-offsite/?url=https://respond.io/help/ai-skills/ai-skill-make-http-requests)[![Twitter](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F4e03e02422a94e8eab9b8b41457c2371?width=22)](http://twitter.com/share?url=https://respond.io/help/ai-skills/ai-skill-make-http-requests) ## Artigos relacionados 👩‍💻 * [Ação do Agente de IA: Adicionar comentáriosAprenda como os Agentes de IA adicionam comentários internos no respond.io para compartilhar contexto, marcar colegas e facilitar repasses. ](/pt/help/ai-skills/ai-agent-action-add-comments) * [Ação do Agente de IA: atribuir a um agente ou a uma equipeSaiba como os Agentes de IA atribuem conversas a agentes, equipes ou outros Agentes de IA no respond.io, incluindo métodos de atribuição, comportamento de transferência e principais limitações. ](/pt/help/ai-skills/ai-skill-assign-to-agent-or-team) * [Ação do Agente de IA: Encerrar conversasSaiba como a ação Fechar conversas funciona para Agentes de IA no respond.io, incluindo como acioná-la, aplicar notas de fechamento e lidar com resumos. ](/pt/help/ai-skills/ai-skill-close-conversations) * [Ação do Agente de IA: Atender ChamadasSaiba como os agentes de IA lidam com chamadas recebidas no respond.io, incluindo o comportamento de voz, as opções de configuração e as principais limitações. ](/pt/help/ai-skills/ai-skill-handle-calls) * [Ação do Agente de IA: Acionar WorkflowSaiba como os Agentes de IA acionam Workflows existentes no respond.io para executar automações e integrações avançadas. ](/pt/help/ai-skills/ai-skill-trigger-workflow) Não consegue encontrar o que você está procurando? 🔎 [Contate o suporte](/pt/contact-us) 2026-10-02T10:06:57.506Z help ```json {"@context":"https://schema.org","@graph":[{"@context":"https://schema.org","@type":"TechArticle","articleBody":"Saiba mais sobre como a ação Make HTTP requests do Agente de IA permite que seu Agente de IA chame APIs externas durante conversas para recuperar dados em tempo real ou acionar ações em sistemas de terceiros.","author":{"@type":"Person","image":"https://assets2-proxy.respond.io/ph8r57dk1q9w/4GvzCieeTBRY4TRJUbIr4y/b92428e6b049d23f546269180534f7ea/Ryan_Tan_Avatar.svg","name":"Joshua Lim","url":"https://respond.io/pt/author"},"dateCreated":"2026-03-04T00:00:00.000Z","dateModified":"2026-10-02T08:29:04.095Z","datePublished":"2026-03-04T00:00:00.000Z","headline":"Ação do Agente de IA: Make HTTP requests","mainEntityOfPage":"https://respond.io/pt/help/ai-skills","publisher":{"@id":"https://respond.io/#organization"},"url":"https://respond.io/pt/help/ai-skills/ai-skill-make-http-requests"},{"@context":"https://schema.org","@id":"https://respond.io/pt/help/ai-skills/ai-skill-make-http-requests#breadcrumb","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Help","item":"https://respond.io/pt/help"},{"@type":"ListItem","position":2,"name":"Produto","item":"https://respond.io/pt/help/product"},{"@type":"ListItem","position":3,"name":"Agentes de IA","item":"https://respond.io/pt/help/ai-agents"},{"@type":"ListItem","position":4,"name":"Ações do Agente de IA","item":"https://respond.io/pt/help/ai-skills"},{"@type":"ListItem","position":5,"name":"Ação do Agente de IA: Make HTTP requests","item":"https://respond.io/pt/help/ai-skills/ai-skill-make-http-requests"}]},{"@type":"Organization","@id":"https://respond.io/#organization","name":"Respond.io","alternateName":"respond.io","url":"https://respond.io/","image":["https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F3f43c48b21b24f4e8b02b100c0c8fab0"],"logo":"https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F4045649d540241d398c39ab07b2b62bb","description":"Respond.io is an AI-powered customer conversation platform that helps businesses manage conversations, automate workflows and scale sales, marketing and support operations. Trusted by 10,000+ B2C brands, it unifies WhatsApp, TikTok, Instagram and Facebook in a single AI-powered team inbox for chats, calls and campaigns.","email":"success@respond.io","telephone":"+6011-54211197","foundingDate":"2017-02-17","address":{"@type":"PostalAddress","streetAddress":"Level 41, Permata Sapura Tower, Jalan Pinang","addressLocality":"Kuala Lumpur","addressRegion":"Federal Territory of Kuala Lumpur","postalCode":"50088","addressCountry":"MY"},"areaServed":"Worldwide","contactPoint":{"@type":"ContactPoint","contactType":"Customer Service","url":"https://respond.io/contact"},"sameAs":["https://respond.io/","https://www.facebook.com/getrespondio/","https://www.linkedin.com/company/respondio/","https://play.google.com/store/apps/details?id=com.respond.inbox.io","https://www.youtube.com/@respondio","https://twitter.com/respond_io","https://apps.apple.com/my/app/respond-io-inbox/id1667772955","https://www.g2.com/products/respond-io/reviews","https://www.producthunt.com/products/respond-io","https://zapier.com/apps/respondio/integrations","https://www.capterra.com/p/179311/Rocketbots/","https://www.crunchbase.com/organization/respondio","https://builtin.com/company/respondio","https://respond-io.en.softonic.com/web-apps","https://my.jobstreet.com/companies/respondio-168558101085004","https://brandfetch.com/respond.io","https://webcatalog.io/en/apps/respond-io"],"knowsAbout":["WhatsApp API","WhatsApp Business API","WhatsApp CRM","WhatsApp automation","omnichannel communication platform","WhatsApp Business Multiple Users","WhatsApp BSP","WhatsApp Business Solution Provider","WhatsApp automation tool","WhatsApp team inbox","WhatsApp AI agent","WhatsApp Business AI chatbot","WhatsApp marketing software","conversational sales platform","WhatsApp appointment booking"]},{"@type":"WebPage","@id":"https://respond.io/pt/help/ai-skills/ai-skill-make-http-requests#webpage","url":"https://respond.io/pt/help/ai-skills/ai-skill-make-http-requests","name":"Ação do Agente de IA: Make HTTP requests","description":"Saiba mais sobre como a ação Make HTTP requests do Agente de IA permite que seu Agente de IA chame APIs externas durante conversas para recuperar dados em tempo real ou acionar ações em sistemas de terceiros.","isPartOf":{"@id":"https://respond.io/#website"},"primaryImageOfPage":{"@type":"ImageObject","url":"https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F3f43c48b21b24f4e8b02b100c0c8fab0"},"breadcrumb":{"@id":"https://respond.io/pt/help/ai-skills/ai-skill-make-http-requests#breadcrumb"}},{"@type":"WebSite","@id":"https://respond.io/#website","name":"Respond.io","url":"https://respond.io/","potentialAction":{"@type":"SearchAction","query-input":"required name=search_term_string","target":"https://respond.io/search?query={search_term_string}"},"publisher":{"@id":"https://respond.io/#organization"}}]} ```