---
title: "Typebot"
description: "Integre a APIBrasil no Typebot usando blocos HTTP Request para criar chatbots conversacionais com validação de CPF, CNPJ, CEP e mais."
lang: pt-BR
canonical: https://doc.apibrasil.io/mcp/chatbots/typebot
markdown: https://doc.apibrasil.io/mcp/chatbots/typebot.md
source: apibrasil-documentation
---

# Typebot

> Integre a APIBrasil no Typebot usando blocos HTTP Request para criar chatbots conversacionais com validação de CPF, CNPJ, CEP e mais.

- **Categoria:** Chatbots
- **Dificuldade:** Fácil
- **Protocolo:** chama o gateway REST por HTTP
- **Atualizado em:** 14 de janeiro de 2026

## Pré-requisitos

- Conta no Typebot (cloud ou self-hosted)
- Conhecimento básico de fluxos Typebot
- Tokens da APIBrasil

## Configuração

- **Arquivo:** `HTTP Request Block Config`

```json
{
  "method": "POST",
  "url": "https://gateway.apibrasil.io/api/v2/cep/cep",
  "headers": [
    {
      "key": "Authorization",
      "value": "Bearer {{secrets.APIBRASIL_BEARER}}"
    },
    {
      "key": "DeviceToken",
      "value": "{{secrets.APIBRASIL_DEVICE}}"
    },
    {
      "key": "Content-Type",
      "value": "application/json"
    }
  ],
  "body": {
    "cep": "{{variables.cep}}"
  }
}
```

## Passo a passo

1. **Criar variável de ambiente** — No Typebot, vá em Settings > Environment Variables e adicione seus tokens da APIBrasil como secrets
2. **Adicionar bloco HTTP Request** — No seu flow, arraste um bloco 'HTTP Request' para onde deseja fazer a consulta
3. **Configurar método e URL** — Defina o método como POST e a URL como gateway.apibrasil.io/api/v2/[endpoint]
   ```text
   Method: POST
   URL: https://gateway.apibrasil.io/api/v2/cep/cep
   ```
4. **Adicionar headers** — Configure os headers de autenticação usando as secrets criadas
   ```text
   Authorization: Bearer {{secrets.APIBRASIL_BEARER}}
   DeviceToken: {{secrets.APIBRASIL_DEVICE}}
   Content-Type: application/json
   ```
5. **Configurar body** — No body, passe os parâmetros necessários usando variáveis do Typebot
   ```json
   {
     "cep": "{{variables.cep}}"
   }
   ```
6. **Salvar resposta em variável** — Configure o bloco para salvar a resposta em uma variável para usar posteriormente no fluxo
7. **Processar resposta** — Use blocos de texto ou condições para exibir os dados retornados pela API ao usuário

## Solução de problemas

- **Secrets não estão sendo substituídos** — Verifique se você usou a sintaxe correta: {{secrets.NOME_DO_SECRET}} em vez de {{variables.nome}}
- **Erro 401 na requisição** — Teste seus tokens diretamente usando Postman ou cURL para garantir que estão válidos
- **Body não está sendo enviado** — Certifique-se de que o Content-Type está definido como application/json nos headers
- **Variável retorna undefined** — Verifique se você configurou corretamente o 'Save response in variable' no bloco HTTP Request

## Links relacionados

- [Documentação oficial Typebot](https://docs.typebot.io)
- [API REST da APIBrasil](https://doc.apibrasil.io/apis.md)
- [Templates Typebot](https://doc.apibrasil.io/mcp/exemplos/typebot.md)
- [Outras plataformas de chatbot](https://doc.apibrasil.io/mcp/chatbots.md)

## Ver também

- Guia MCP: [Guia MCP](https://doc.apibrasil.io/mcp.md)
- Índice da documentação: https://doc.apibrasil.io/llms.txt
- Versão HTML desta página: https://doc.apibrasil.io/mcp/chatbots/typebot