> ## Documentation Index
> Fetch the complete documentation index at: https://help.wizebot.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Como criar uma integração HTTP

> Cadastre a ligação com o sistema da sua loja, teste a chamada e acompanhe no relatório cada consulta feita pelos fluxos

![Janela Criar Integração HTTP com a integração Status do pedido testada com sucesso](https://mintcdn.com/wizebot-d8529edc/4j4gWlfYpoLvaWl_/images/integracoes-http/capa.png?fit=max\&auto=format\&n=4j4gWlfYpoLvaWl_\&q=85\&s=992244f0755f33d31b414638ac1cce7d)

Uma integração HTTP é a ligação entre a WizeBot e outro sistema, como a sua loja virtual, o seu ERP ou a sua plataforma de pagamento. Você cadastra uma vez o endereço e o acesso desse sistema, e os fluxos passam a consultar dados nele durante a conversa. Por exemplo: o cliente pergunta pelo pedido e o fluxo responde na hora com o status que está no sistema da loja.

Antes de começar, tenha em mãos a documentação da API do sistema que você quer consultar. API é a porta de entrada que um sistema oferece para outros programas conversarem com ele. É lá que estão o endereço a chamar e a chave de acesso, normalmente na área de desenvolvedor ou de integrações do sistema.

Neste tutorial, o exemplo é uma integração chamada **Status do pedido**, que consulta `https://api.lojaexemplo.com.br/pedidos/{{pedido}}`.

## Criar a integração

**1. Abra a tela de integrações**

Acesse **Configurações** > **Integrações HTTP**. A tela lista as integrações que já existem, com o método, o endereço e se cada uma está **Ativo** ou **Inativo**. Clique em **Nova Integração**.

![Tela Integrações HTTP com quatro integrações na lista e o botão Nova Integração destacado](https://mintcdn.com/wizebot-d8529edc/4j4gWlfYpoLvaWl_/images/integracoes-http/01-tela-integracoes.png?fit=max\&auto=format\&n=4j4gWlfYpoLvaWl_\&q=85\&s=86f4fe8ae7d0778f8d0c9d7497cb5244)

**2. Preencha nome, método e URL**

A janela **Criar Integração HTTP** abre na aba **Básico**. Preencha:

1. **Nome**: como a integração vai aparecer na lista e nos fluxos, por exemplo "Status do pedido". Cada integração precisa de um nome diferente.
2. **Método HTTP**: o tipo de pedido feito ao outro sistema. Use `GET` para buscar uma informação, `POST` para enviar um dado novo, `PUT` ou `PATCH` para alterar e `DELETE` para apagar. A documentação da API diz qual usar.
3. **URL da Requisição**: o endereço completo que será chamado, como `https://api.lojaexemplo.com.br/pedidos/{{pedido}}`.

O campo **Descrição** é opcional e ajuda a equipe a lembrar para que serve a integração. A chave **Integração ativada** vem ligada; desligada, os fluxos não fazem a chamada.

![Aba Básico com Nome, Método HTTP e URL da Requisição numerados e a variável pedido destacada em verde na URL](https://mintcdn.com/wizebot-d8529edc/4j4gWlfYpoLvaWl_/images/integracoes-http/02-aba-basico.png?fit=max\&auto=format\&n=4j4gWlfYpoLvaWl_\&q=85\&s=d9bd80116104e23f8f6f69a1e3377103)

**3. Use uma variável na URL**

Uma variável é um espaço que a WizeBot preenche com o dado do contato na hora da chamada. Ela vai entre chaves duplas: `{{pedido}}` vira o número do pedido daquele cliente, por exemplo `https://api.lojaexemplo.com.br/pedidos/10482`.

Para não errar o nome, clique no ícone **{ }** no fim do campo e escolha a variável na lista. Ela traz os dados do contato (nome, telefone, e-mail), os **Campos Personalizados** e os dados de data e hora. No exemplo, `{{pedido}}` vem do campo personalizado **Pedido**. Para criar um campo novo, veja [Campos personalizados](https://help.wizebot.com.br/tutoriais/gerenciador-contatos/campos-personalizados.md).

![Lista de variáveis aberta pelo ícone de chaves, com o campo personalizado Pedido e a variável pedido destacados](https://mintcdn.com/wizebot-d8529edc/4j4gWlfYpoLvaWl_/images/integracoes-http/03-variavel.png?fit=max\&auto=format\&n=4j4gWlfYpoLvaWl_\&q=85\&s=1da0475661ea217b8fd4066e9a8f2bb1)

**4. Configure a autorização, se a API pedir**

A maioria das APIs só responde a quem apresenta uma chave de acesso. Abra a aba **Auth** e, em **Tipo de Autenticação**, escolha a forma que a documentação da API indica:

* **Bearer Token**: a chave vai no campo **Bearer Token** e a WizeBot envia no formato `Bearer <sua chave>`.
* **Basic Auth**: **Usuário** e **Senha**.
* **API Key**: a chave em **API Key** e, em **Nome do Header**, o nome que a API espera, como `X-API-Key`.

A chave aparece escondida com pontos enquanto você digita. Depois de salva, ela não é mostrada de novo na tela.

![Aba Auth com Tipo de Autenticação em Bearer Token e o campo Bearer Token preenchido e escondido com pontos](https://mintcdn.com/wizebot-d8529edc/4j4gWlfYpoLvaWl_/images/integracoes-http/05-aba-auth.png?fit=max\&auto=format\&n=4j4gWlfYpoLvaWl_\&q=85\&s=d1a475ec1897a6f86254947bdf87d041)

> [!WARNING]
>
> A chave de acesso dá entrada no seu sistema. Copie a chave direto do painel da API e não mande por mensagem ou print.

**5. Adicione cabeçalhos extras, se precisar**

Cabeçalho (header) é uma informação que vai junto com o pedido, como o formato de resposta esperado. Só preencha se a documentação da API pedir algum além da autorização.

Na aba **Headers**, clique em **Adicionar**. Na primeira caixa escreva o nome do cabeçalho, como `Accept`, e na segunda o valor, como `application/json`. O valor também aceita variáveis.

![Aba Headers com o botão Adicionar, o nome Accept e o valor application/json numerados](https://mintcdn.com/wizebot-d8529edc/4j4gWlfYpoLvaWl_/images/integracoes-http/04-aba-headers.png?fit=max\&auto=format\&n=4j4gWlfYpoLvaWl_\&q=85\&s=9cafa04dbc284938d60b9756900c6eb7)

**6. Monte o corpo, se o método enviar dados**

Corpo (body) é o conteúdo que a WizeBot manda junto, usado com `POST`, `PUT` e `PATCH`. Numa consulta com `GET`, como a do exemplo, deixe a aba **Body** em **Nenhum**.

Para enviar dados, abra a aba **Body** e escolha o **Tipo do Body**: **JSON**, **Form Data**, **Texto** ou **XML**. Use o que a documentação da API pede. Um cadastro de cliente em JSON, com variáveis do contato, fica assim:

```json theme={null}
{
  "nome": "{{name}}",
  "telefone": "{{phone}}"
}
```

**7. Teste a chamada**

Volte para a aba **Básico**. Em **Contato para Teste**, busque e escolha um contato que tenha os dados usados nas variáveis. A URL passa a mostrar o valor dele em azul, como `10482`.

Clique em **Testar**. A WizeBot faz uma chamada de verdade ao outro sistema e mostra o resultado embaixo da janela:

* **Teste realizado com sucesso**, com o código da resposta (200 quer dizer que deu certo) e o tempo que a API levou.
* **Erro no teste**, com o motivo. Um código 401 ou 403 costuma ser chave de acesso errada; 404, endereço ou dado que não existe.

Clique em **Resposta** para ver os dados que a API devolveu. Esses dados podem ser gravados nos campos do contato na aba **Resposta**, como explicado em [Blocos de integração](https://help.wizebot.com.br/tutoriais/fluxos/blocos-integracoes.md).

![Aba Básico com o contato Mariana Souza escolhido, o botão Testar e o resultado Teste realizado com sucesso com código 200 numerados](https://mintcdn.com/wizebot-d8529edc/4j4gWlfYpoLvaWl_/images/integracoes-http/06-testar.png?fit=max\&auto=format\&n=4j4gWlfYpoLvaWl_\&q=85\&s=2052fc98ca7a2a442aea12d7e26a65b3)

> [!NOTE]
>
> O teste faz uma chamada real. Se a integração usa `POST`, `PUT`, `PATCH` ou `DELETE`, o outro sistema vai cadastrar, alterar ou apagar o dado de verdade. Teste esses métodos com um contato seu.

**8. Salve**

Clique em **Salvar**. Aparece o aviso **Integração criada** e a integração entra na lista. Para mudar algo depois, clique na linha da integração.

No menu **...** de cada linha você também encontra **Duplicar**, **Exportar** (baixa um arquivo para levar a integração para outra conta) e **Excluir**. O botão com a seta para cima, ao lado de **Relatórios**, importa um arquivo exportado.

![Lista de integrações com Status do pedido destacada e o aviso Integração criada no topo](https://mintcdn.com/wizebot-d8529edc/4j4gWlfYpoLvaWl_/images/integracoes-http/07-salvar.png?fit=max\&auto=format\&n=4j4gWlfYpoLvaWl_\&q=85\&s=6f5ac8fc6b8ce367db728e3a63337993)

## Onde a integração é usada

A integração sozinha não faz chamadas. Ela é usada pelo bloco **Integração HTTP** dentro de um fluxo: o bloco chama a integração no ponto da conversa que você escolher, guarda a resposta e permite usar os dados na mensagem seguinte, como "Seu pedido 10482 está: Saiu para entrega". O vídeo mostra o bloco em uso:

<video controls playsInline preload="metadata" poster="/images/fluxo-blocos-integracoes/video.jpg" src="https://mintcdn.com/wizebot-d8529edc/QtghSSUeildsD71i/images/fluxo-blocos-integracoes/video.mp4?fit=max&auto=format&n=QtghSSUeildsD71i&q=85&s=ada097aadc6fd7fb882a5b9702879bf7" aria-label="Vídeo de 86 segundos mostrando como usar os blocos Google Sheets e Integração HTTP num fluxo" />

O passo a passo do bloco, com a opção de guardar a resposta, a saída **Falha** e o que acontece quando a API não responde, está em [Blocos de integração](https://help.wizebot.com.br/tutoriais/fluxos/blocos-integracoes.md).

## Acompanhar as chamadas no relatório

O relatório mostra cada chamada que os fluxos fizeram às suas integrações, com o resultado. É o lugar para descobrir por que um cliente não recebeu o status do pedido, por exemplo. Os testes feitos na janela da integração não entram no relatório.

**1. Abra o relatório**

Na tela **Integrações HTTP**, clique em **Relatórios**. A tela **Relatório de Chamadas HTTP** lista as chamadas mais recentes primeiro, com:

* **Status**: o ícone verde indica sucesso e o vermelho, falha.
* **Método** e **URL / Descrição**: o tipo de pedido, o sistema chamado e um resumo do resultado.
* **Código**: o código da resposta. Começando com 2, deu certo; com 4, o outro sistema recusou o pedido (dado inexistente, chave errada); com 5, o outro sistema teve um problema.
* **Tempo** e **Data**: quanto a resposta demorou e quando a chamada aconteceu.

![Relatório de Chamadas HTTP com seis chamadas e a linha da chamada com código 404 destacada](https://mintcdn.com/wizebot-d8529edc/4j4gWlfYpoLvaWl_/images/integracoes-http/08-relatorio.png?fit=max\&auto=format\&n=4j4gWlfYpoLvaWl_\&q=85\&s=fce83b2ea2919375dea80931212ae68c)

Para achar uma chamada, use **Buscar por URL, método...** ou clique em **Filtros** e escolha **Sucesso (2xx)**, **Erro cliente (4xx)**, **Erro servidor (5xx)** ou **Falha / Timeout**. A busca e o filtro valem para as chamadas da página aberta. O botão com as setas circulares atualiza a lista.

**2. Veja o detalhe de uma chamada**

Clique numa linha para abrir **Detalhes da Chamada**. A janela mostra o endereço exato que foi chamado, já com a variável preenchida, e, quando a chamada falhou, o quadro **Erro** com o motivo.

Em **Request** ficam os cabeçalhos e o corpo enviados. A autorização aparece escondida com pontos. Em **Response** fica o que o outro sistema respondeu. No exemplo, a API respondeu que o pedido 99999 não existe: o cliente digitou um número errado.

![Janela Detalhes da Chamada com Falha, código 404 Not Found, a URL chamada, o quadro Erro destacado e a resposta Pedido não encontrado](https://mintcdn.com/wizebot-d8529edc/4j4gWlfYpoLvaWl_/images/integracoes-http/09-detalhe.png?fit=max\&auto=format\&n=4j4gWlfYpoLvaWl_\&q=85\&s=1d42d1bccf00471d9de8c3ded6157f66)

## Problemas comuns

> [accordion] Aparece URL inválida embaixo do campo
>
> O endereço precisa estar completo, começando por `https://`. Confira se não há espaço no meio e se cada variável tem duas chaves de cada lado, como `{{pedido}}`.

> [accordion] O teste chama o endereço sem o valor da variável
>
> Escolha um **Contato para Teste** que tenha o dado preenchido. Sem contato, ou com o campo vazio, a variável sai em branco e o endereço fica incompleto.

> [accordion] O teste mostra erro 401 ou 403
>
> A API recusou a chave de acesso. Confira na aba **Auth** se o tipo de autenticação é o que a documentação pede e cole a chave de novo.

> [accordion] Já existe uma integração com esse nome
>
> Cada integração precisa de um nome diferente. Troque o nome e clique em **Salvar** de novo.

> [accordion] O relatório está vazio
>
> O relatório só mostra chamadas feitas pelos fluxos. Confira se a integração está escolhida num bloco **Integração HTTP** de um fluxo ativo e se algum contato já passou por esse bloco.

## Precisa de ajuda?

Fale com o suporte da WizeBot pelo WhatsApp ou por e-mail.

> [card] [WhatsApp](https://wa.me/559192226534)
>
> Falar com o suporte

> [card] [E-mail](mailto:suporte@wizebot.com.br)
>
> Enviar um e-mail


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.