---
title: Chamada de API
slug: helper-new/chamada-de-api
description: Learn how to efficiently utilize the Call API skill in Botpress for making API requests in chatbot flows. This comprehensive document covers key aspects such as request body, headers, and storing API responses in memory. Discover effective techniques for 
createdAt: 2022-08-31T11:07:29.000Z
---

Desenvolvemos a habilidade Call API para ajudar você a chamar rapidamente uma API em seu fluxo. Você pode salvar e usar as respostas recebidas da API externa no código e nos fluxos do seu chatbot.

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/t36dvFHQ_wW00sQROFIoO_image.png)

## Opções de Solicitação

Chamar uma API envolve fazer uma solicitação HTTP do Botpress para um host nomeado em um servidor. A requisição visa acessar um recurso no servidor. A seguir estão os componentes de sua solicitação por meio dos quais você fornecerá informações a uma API.

## Corpo

O corpo da solicitação é definido na interface abaixo. Certifique-se de que o corpo da solicitação esteja de acordo com a sintaxe especificada para a API que você está chamando.

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/lBjiTKR0ecGV2aR66Bwfz_image.png)

## Cabeçalhos

Os cabeçalhos de solicitação podem ser definidos aqui e devem respeitar o formato JSON.

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/ouwMakvxEwXrE1XxGCC3R_image.png)

## Resposta

Todas as APIs respondem a cada solicitação com um status HTTP indicando se a solicitação foi bem-sucedida. A resposta normalmente vem com uma resposta json que pode conter informações adicionais. 

A habilidade Call API oferece suporte ao recebimento e armazenamento dessa resposta da seguinte maneira.

## Memória

Usamos memória para salvar a resposta dada pela API que estamos chamando. 

Por padrão, o Botpress salvará a resposta em temp.response, mas é possível usar a memória de sua escolha de acordo com o caso de uso.

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/QgCwxtCcvx3VbWV22985r_image.png)

O objeto de resposta salvo se parece com isso:

:::CodeblockTabs
Exemplo do Objeto de Resposta

```javascript
{
  "body": <Response Body>,
  "status": 200
}
```
:::

## Sucesso/Fracasso

Quando uma resposta retornar um código de status `400` e acima, a solicitação falhará e executará a `On failure` transição. 

Todos os outros códigos de status resultarão em sucesso e executarão a `On success` transição.

## Modelagem

Botpress suporta modelagem no `body` e `headers` para acessar variáveis ​​armazenadas na memória. 

Todos os tipos de memória `bot`, `user`, `session`, `temp` e `event` são acessíveis por meio de modelos.

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/uH2GAZDx8Oq_OsaA6klt6_image.png)