# Vales-presente para agentes de IA

> A Bidali vende vales-presente de 4.700+ marcas em 100+ países. Esta página explica como um agente pode ler o catálogo deste site e como pode comprar pela API da Bidali.

## O que um agente pode fazer aqui hoje

O catálogo é público e pode ser lido sem conta.

- **Navegar pelo catálogo**: Cada país, categoria, moeda e marca tem sua própria página em uma URL estável. As páginas são renderizadas no servidor, então o conteúdo está no HTML.
- **Começar pelos arquivos do site**: [/llms.txt](https://giftcards.bidali.com/llms.txt) descreve o site em linguagem simples. [/sitemap.xml](https://giftcards.bidali.com/sitemap.xml) lista todas as páginas destinadas a mecanismos de busca e agentes.
- **Ler dados estruturados**: Cada página de marca traz dados Product do schema.org com os valores disponíveis do vale-presente e a respectiva moeda.
- **Conferir país e moeda**: Um vale-presente é listado no país a que se destina e tem preço em uma única moeda. Confira os dois antes de recomendar ou comprar.

O catálogo também está disponível como API JSON, com uma especificação OpenAPI e uma versão em Markdown de cada página. https://giftcards.bidali.com/pt/developers

## Dê aos agentes um orçamento, não um número de cartão

Os agentes compram pela Gift Card API da Bidali com um orçamento definido pela empresa. Um vale-presente funciona em uma única marca e tem valor fixo, então um erro ou um prompt manipulado só consegue gastar o que foi autorizado.

1. **A empresa define o orçamento**: Ela carrega um saldo pré-pago. O agente pode gastar esse saldo e nada mais.
2. **O agente pede uma cotação**: Ele envia a marca, o valor e a moeda e recebe um preço antes de confirmar.
3. **O agente faz o pedido**: O pedido é criado a partir da cotação e pago com o saldo pré-pago.
4. **O vale-presente é entregue**: O agente ou a pessoa para quem ele está comprando recebe o vale-presente.

- A Gift Card API está em acesso antecipado, então os detalhes podem mudar. A documentação é a referência.
- O acesso por MCP chegará em breve.
- O checkout deste site foi feito para pessoas. Para compras automatizadas, use a API.

- Ler a documentação: https://docs.bidali.com
- Gift Card API: https://www.bidali.com/products/gift-card-api
- Falar com vendas: https://www.bidali.com/contact?intent=sales

## Padrões de URL

- `https://giftcards.bidali.com/buy/{country}`: Todos os vales-presente de um país.
- `https://giftcards.bidali.com/buy/{country}/{category}`: Vales-presente de um país em uma categoria.
- `https://giftcards.bidali.com/brands/{country}`: Marcas populares em um país.
- `https://giftcards.bidali.com/brands/{country}/{brand}`: Uma marca em um país: valores, moeda e como resgatar.
- `https://giftcards.bidali.com/shop/{category}`: Uma categoria, com as marcas do país do visitante. Use o padrão com país quando o país for importante.
- `https://giftcards.bidali.com/currency/{code}`: Vales-presente com preço em uma moeda. O código é um código ISO 4217 em minúsculas.
- `https://giftcards.bidali.com/currency`: Todas as moedas com vales-presente disponíveis.
- `https://giftcards.bidali.com/countries`: Todos os países com vales-presente disponíveis.

## Perguntas de quem desenvolve agentes

### Um agente de IA pode comprar um vale-presente sozinho?

Sim, pela Gift Card API da Bidali, que está em acesso antecipado. Um agente pode pedir uma cotação, fazer um pedido e receber o vale-presente, tudo dentro do orçamento definido pela empresa.

### Por que dar vales-presente a um agente em vez de um número de cartão?

Um vale-presente funciona em uma única marca e tem valor fixo. Se um agente errar ou for enganado por um prompt, ele só consegue gastar o que recebeu.

### Existe um servidor MCP?

O acesso por MCP chegará em breve.

### Como um agente encontra vales-presente para um país ou uma moeda?

Use /buy/{country} para um país e /currency/{code} para uma moeda. /countries e /currency listam todas as opções.

### Algum agente de IA já fez isso?

Sim. Em março de 2026, Beppe, um agente autônomo criado pela Treasure, comprou um vale-presente da Bidali, usou-o para pedir comida e mandou entregar a comida em um banco de alimentos.

## Other formats

- HTML page: https://giftcards.bidali.com/pt/agents
- This page as Markdown: https://giftcards.bidali.com/pt/agents.md
- Same data as JSON (Catalogue API): https://giftcards.bidali.com/api/v1
- Guide to this store for AI agents: https://giftcards.bidali.com/llms.txt
- Catalogue API reference (OpenAPI 3.1): https://giftcards.bidali.com/openapi.json

## Languages

[English](https://giftcards.bidali.com/agents.md) · [Español](https://giftcards.bidali.com/es/agents.md) · [Português](https://giftcards.bidali.com/pt/agents.md) · [Français](https://giftcards.bidali.com/fr/agents.md) · [Deutsch](https://giftcards.bidali.com/de/agents.md) · [Italiano](https://giftcards.bidali.com/it/agents.md) · [Polski](https://giftcards.bidali.com/pl/agents.md) · [Svenska](https://giftcards.bidali.com/sv/agents.md)
