Para agentes de IA e para quem os desenvolve
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.
Neste site
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 descreve o site em linguagem simples. /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.
Compras
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.
Referência
Padrões de URL
Todos os caminhos são relativos a https://giftcards.bidali.com. Os slugs ficam em minúsculas e usam hifens.
| Padrão | O que você recebe | Exemplo |
|---|---|---|
/buy/{country} | Todos os vales-presente de um país. | /buy/germany |
/buy/{country}/{category} | Vales-presente de um país em uma categoria. | /buy/germany/groceries |
/brands/{country} | Marcas populares em um país. | /brands/germany |
/brands/{country}/{brand} | Uma marca em um país: valores, moeda e como resgatar. | /brands/germany/123-blumenversand-de |
/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. | /shop/groceries |
/currency/{code} | Vales-presente com preço em uma moeda. O código é um código ISO 4217 em minúsculas. | /currency/eur |
/currency | Todas as moedas com vales-presente disponíveis. | /currency |
/countries | Todos os países com vales-presente disponíveis. | /countries |
Para outro idioma, coloque o código dele antes do caminho: /es, /pt, /fr, /de, /it, /pl, /sv. O inglês não tem prefixo.
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.
Onde fica a documentação da API?
Em docs.bidali.com. A página da Gift Card API em bidali.com/products/gift-card-api lista os endpoints e tem o formulário de acesso antecipado.
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.
Dê ao seu agente um orçamento, não um número de cartão
Conte o que você está desenvolvendo e ajudamos a configurar tudo.