Atribuição de conversão

Segundo passo depois dos Smart Links: o clique já é registrado automaticamente, e para saber se o cliente comprou o seu backend reporta a conversão para a Arara, que liga a venda à última mensagem enviada àquele telefone.

Não existe pixel JavaScript nem integração nativa com Shopify, WooCommerce ou Stripe para conversão. A atribuição é feita por chamada server-side, com o telefone como chave.

Como a atribuição funciona

Você envia phone, order_id e value para o endpoint de conversão da sua organização.
A Arara procura a última mensagem enviada a esse telefone nos últimos 7 dias.
Se encontrar, a conversão fica ligada a essa mensagem.
A conversão atribuída alimenta a métrica CONVERTED do teste A/B de campanha e o valor recuperado em GET /v1/recovery/stats.

Endpoint de conversão

Cada organização tem um endpoint próprio, com código no formato ara_cnv_.... Ele nasce ativo.

Hoje GET /v1/conversions/endpoint só aceita a sessão do dashboard: chamado com chave ara_live_, responde 403. Enquanto isso não muda, peça o código do seu endpoint ao suporte.

Endpoint (sessão do dashboard)	Função
`GET /v1/conversions/endpoint`	`{ code, hmacSecret, active, url }`
`POST /v1/conversions/endpoint/regenerate`	Gera novo código
`GET /v1/conversions/ingests?page=0&size=20`	Conversões recebidas `{ content, totalPages, totalElements }`

Reportando uma conversão

Quando o pedido for confirmado no seu backend:

curl -X POST https://api.ararahq.com/l/ara_cnv_xxx \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+5511999999999",
    "order_id": "ORDER_12345",
    "value": 199.90
  }'

await fetch(`https://api.ararahq.com/l/${conversionCode}`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    phone: order.customerPhone,   // E.164
    order_id: order.id,
    value: order.total,           // em reais, ex.: 199.90
  }),
});

Campo	Descrição
`phone`	Telefone do cliente. É a chave de atribuição
`order_id`	Id do pedido (`orderId` também é aceito). Um `order_id` já recebido não gera nova conversão
`value`	Valor da venda, em reais

O header opcional X-Arara-Event define o tipo registrado (default conversion). A resposta é 202:

{
  "ingestId": "ara_civ_...",
  "attributedCampaignId": null,
  "attributedMessageId": "ara_msg_..."
}

attributedMessageId vem null quando não houve mensagem para esse telefone nos últimos 7 dias.

Mande sempre order_id. Gateways reenviam webhook. Sem order_id, cada reenvio vira uma conversão nova.

Use https://api.ararahq.com/l/{code}. O url devolvido pelo endpoint aponta para ararahq.com/l/{code}, que só aceita GET.

A partir do webhook do seu gateway

Shopify (orders/paid), Stripe (checkout.session.completed), WooCommerce e AbacatePay avisam quando o pedido é pago. No handler desse webhook, faça o POST acima com o telefone, o id e o valor do pedido.

Validando

Sintoma	Causa provável
`attributedMessageId` nulo	Nenhuma mensagem para esse telefone nos últimos 7 dias, ou telefone em formato diferente do usado no envio. Use E.164 (`+5511999999999`)
Conversão não aparece de novo	O `order_id` já tinha sido recebido
Valor recuperado zerado na recuperação de receita	A conversão não foi atribuída a uma mensagem de recuperação
`403 RECOVERY_ENDPOINT_INACTIVE`	Endpoint de conversão desativado

Dados registrados

Clique: IP, user agent, referer e país (quando disponível).
Conversão: telefone, order_id, valor e o corpo recebido.

Declare na sua política de privacidade que usa a Arara para medir resultado das mensagens. Ver Compliance.

Receitas

Recursos

Automações

Brain (IA)

Integrações

Migrar de

Como a atribuição funciona

Endpoint de conversão

Reportando uma conversão

A partir do webhook do seu gateway

Validando

Dados registrados

Próximos passos

Recuperação de receita

Campanhas de marketing

​Como a atribuição funciona

​Endpoint de conversão

​Reportando uma conversão

​A partir do webhook do seu gateway

​Validando

​Dados registrados

​Próximos passos

Recuperação de receita

Campanhas de marketing

Como a atribuição funciona

Endpoint de conversão

Reportando uma conversão

A partir do webhook do seu gateway

Validando

Dados registrados

Próximos passos