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

# Introdução

> O que é a Atriby, quais problemas resolve e quais integrações estão disponíveis hoje.

Atriby é uma plataforma de atribuição de vendas para operações digitais que vendem com tráfego pago. Ela conecta o clique do anúncio ao pedido real do checkout, para que você acompanhe campanhas, pedidos pagos, ticket médio e aprovação com base em dados enviados pelo seu próprio backend.

## Para quem é

A Atriby foi desenhada para operadores de e-commerce, infoprodutos, serviços e times de tráfego que precisam entender quais campanhas geram pedidos reais. Ela é útil quando o pixel da plataforma de anúncios não basta, quando o checkout está em outro domínio ou quando a operação precisa validar receita confirmada, não apenas eventos de navegador.

## O que funciona hoje

* Orders API para criar, listar, consultar e atualizar pedidos.
* API tokens `atb_live_*` para autenticação server-side.
* Script público de UTMs para capturar e propagar parâmetros no navegador.
* Webhooks de pedido com assinatura HMAC e retry manual.
* Links UTM com histórico, edição, arquivamento e QR code client-side.
* Dashboard autenticado para acompanhar resumo, pedidos, campanhas agregadas e áreas operacionais.

## O que ainda é futuro

Algumas áreas existem como parcial, preview ou roadmap. A Atriby ainda não entrega Meta CAPI, Google Ads API, TikTok API, billing self-service, IA, worker automático de webhooks, short links rastreáveis ou tracking backend de cliques por QR.

## Como as peças se conectam

| Peça           | Responsabilidade                                                                            |
| -------------- | ------------------------------------------------------------------------------------------- |
| Orders API     | Seu backend envia pedidos e atualizações de status para a Atriby.                           |
| Script de UTMs | O navegador captura UTMs/click IDs e propaga para checkout, links, forms e iframes.         |
| Webhooks       | A Atriby notifica seu servidor quando pedidos são criados ou mudam para estados suportados. |
| Links UTM      | O painel ajuda a montar URLs com UTMs, salvar histórico e gerar QR client-side.             |

O script de UTMs não cria pedidos e não deve receber tokens. O fluxo seguro é: visitante chega na oferta, o script preserva a atribuição, o checkout envia os dados ao seu backend, e o seu backend chama a Orders API com um token secreto.