---
title: "Dify.ai"
description: "Integre a APIBrasil no Dify.ai usando API Extensions para criar agentes de IA com acesso a dados brasileiros em tempo real."
lang: pt-BR
canonical: https://doc.apibrasil.io/mcp/chatbots/dify
markdown: https://doc.apibrasil.io/mcp/chatbots/dify.md
source: apibrasil-documentation
---

# Dify.ai

> Integre a APIBrasil no Dify.ai usando API Extensions para criar agentes de IA com acesso a dados brasileiros em tempo real.

- **Categoria:** Chatbots
- **Dificuldade:** Médio
- **Protocolo:** chama o gateway REST por HTTP
- **Atualizado em:** 14 de janeiro de 2026

## Pré-requisitos

- Conta no Dify.ai (self-hosted ou cloud)
- Conhecimento básico de OpenAPI/Swagger
- Tokens da APIBrasil

## Configuração

- **Arquivo:** `apibrasil-openapi.yaml`

```yaml
openapi: 3.0.0
info:
  title: APIBrasil
  version: 2.0.0
servers:
  - url: https://gateway.apibrasil.io/api/v2
security:
  - bearerAuth: []
  - deviceToken: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
    deviceToken:
      type: apiKey
      in: header
      name: DeviceToken
paths:
  /cep/cep:
    post:
      summary: Consultar CEP
      operationId: consultarCep
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                cep:
                  type: string
                  example: "01001000"
      responses:
        '200':
          description: Sucesso
          content:
            application/json:
              schema:
                type: object
```

## Passo a passo

1. **Criar schema OpenAPI** — Crie um arquivo YAML ou JSON com o schema OpenAPI da APIBrasil (exemplo acima)
2. **Importar no Dify** — No Dify Studio, vá em Tools > API Extensions > Import OpenAPI
3. **Configurar autenticação** — Adicione suas credenciais da APIBrasil na seção de autenticação
   ```text
   Bearer Token: seu_bearer_token
   Device Token: seu_device_token
   ```
4. **Testar a ferramenta** — Use o Test Tool do Dify para validar a conexão com a APIBrasil
5. **Adicionar ao Agent** — No seu Agent ou Chatflow, adicione a ferramenta APIBrasil na lista de tools disponíveis
6. **Configurar prompts** — Configure os prompts do agente para usar a APIBrasil quando necessário, por exemplo: 'Quando o usuário perguntar sobre CEP, use a ferramenta consultarCep'

## Solução de problemas

- **Erro ao importar OpenAPI** — Verifique se o YAML está bem formatado. Use um validador online como swagger.io/tools
- **Autenticação falhando** — Certifique-se de que está passando tanto o Bearer Token quanto o Device Token nos headers corretos
- **Agente não usa a ferramenta** — Seja mais explícito nos prompts do sistema, mencionando quando e como usar as ferramentas da APIBrasil
- **Timeout nas requisições** — Aumente o timeout nas configurações avançadas do Dify para APIs que podem demorar mais

## Links relacionados

- [Documentação oficial Dify](https://docs.dify.ai)
- [OpenAPI Spec da APIBrasil](https://doc.apibrasil.io/mcp/exemplos/openapi.md)
- [Outras plataformas de chatbot](https://doc.apibrasil.io/mcp/chatbots.md)
- [Integração com Flowise](https://doc.apibrasil.io/mcp/chatbots/flowise.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/dify