---
title: "CrossUp para desenvolvedores e agentes"
canonical: "https://crossup.ai/pt/desenvolvedores"
locale: "pt"
---

# Leve o SalesPilot para o seu código e para o seu agente.

Pergunte à sua loja como ela está vendendo direto no Claude, integre recomendações com um SDK que nunca quebra a sua página e meça cada venda com a API. Tudo documentado para pessoas e para agentes, em português, espanhol e inglês.

- [Explore a documentação](https://docs.crossup.ai/pt/introduccion)
- [llms.txt](https://docs.crossup.ai/llms.txt)

## SalesPilot no Claude: Sua loja, agora no Claude.

O SalesPilot é o conector da CrossUp para o Claude: você pergunta à sua loja como ela vai e ela responde com os seus números. Ele é adicionado com uma URL, autorizado com a sua sessão da CrossUp, e não há nenhuma chave para copiar.

**No claude.ai, no Claude Desktop ou no celular**

1. Abra Personalizar → Conectores → Adicionar → Conector personalizado.
2. Nome: SalesPilot. Endereço do servidor: a URL abaixo. Toque em Adicionar e depois em Conectar.
3. O Claude leva você à CrossUp: entre com a sua conta, confira o que ele vai poder fazer e toque em Permitir.

`https://salespilot.crossup.ai/mcp/merchants`

**No Claude Code**

```sh
claude mcp add --transport http salespilot https://salespilot.crossup.ai/mcp/merchants
```

Depois escreva /mcp, escolha salespilot e toque em Authenticate.

O Cursor e os clientes que não fazem OAuth usam uma chave de agente (sak_…) no header Authorization.

**O que você pode perguntar**

- «Como foi este ciclo?»
- «Qual momento rende mais?»
- «O que o SalesPilot mais vendeu no checkout?»
- «Desligue o SalesPilot na página de produto.»

- 24 ferramentas: métricas, o relatório de vendas, os momentos, SalesPilot ligado ou desligado e o seu feedback.
- OAuth 2.1 com PKCE e registro dinâmico de clientes: nenhuma chave para copiar e colar.
- Antes de desligar o SalesPilot, ele mostra o que muda e pede confirmação. Criar ou editar sugestões continua no painel.
- A conexão aparece em API & Agentes → Conexões ativas, e você a revoga quando quiser.

- [Como conectar o Claude](https://docs.crossup.ai/pt/agentes/salespilot-en-claude)
- [As 24 ferramentas](https://docs.crossup.ai/pt/agentes/mcp)

## Storefront SDK: Recomendações na sua loja, sem risco para a sua página.

Para lojas VTEX, próprias ou headless: o @crossup/storefront pede recomendações, acompanha o visitante e envia os sinais em lotes. Se a CrossUp não responder, a sua loja continua vendendo.

```sh
npm install @crossup/storefront
```

```ts
import { createStorefront } from "@crossup/storefront";

const crossup = createStorefront({
  apiKey: "spk_…",       // a sua chave pública de storefront
  connectionId: "cn_…",  // a conexão da sua loja
});

const decision = await crossup.tryGetRecommendations({
  surface: "pdp",
  placementKey: "pdp-related",
  contextItemId: item.id,
});
// null se algo falhou: a sua página continua igual

if (decision) crossup.track.impression(decision); // o bloco foi visto
```

- 0.1.0 · MIT · com tipos · sem dependências de terceiros.
- Roda no navegador e no servidor.
- A chave spk_ é pública por design e fica vinculada ao seu domínio: a loja sai da chave.
- tryGetRecommendations devolve null em vez de lançar um erro, e track.* nunca espera a rede.

Servidor ou conector? O @crossup/sdk é o cliente da API, gerado a partir do contrato OpenAPI.

- [Instalar o SDK](https://docs.crossup.ai/pt/storefront/instalar)
- [@crossup/storefront](https://www.npmjs.com/package/@crossup/storefront) · [@crossup/sdk](https://www.npmjs.com/package/@crossup/sdk)

## API v1: Duas chamadas bastam.

Peça uma recomendação e registre o que o comprador fez com ela. Com as duas, cada venda fica atribuída, pedido a pedido.

| Método | Rota | Para quê |
| --- | --- | --- |
| POST | `/v1/recommendations` | Peça o que recomendar em um momento da compra. |
| POST | `/v1/connections/{connection_id}/storefront-signals` | Registre o que o comprador fez, até 50 sinais por lote. |
| GET | `/v1/catalog/items/{item_id}` | Leia um produto do catálogo, com variantes e disponibilidade. |
| POST | `/v1/connections/{connection_id}/ingest-signals` | Para conectores: envie os eventos de catálogo da sua plataforma. |

```sh
curl -X POST "$CROSSUP_BASE_URL/v1/recommendations" \
  -H "Authorization: Bearer $CROSSUP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "connection_id": "cn_…",
    "surface": "pdp",
    "placement_key": "pdp-related",
    "context_item_id": "itm_…"
  }'
```

A URL base está na referência da API; a chave e o connection_id você gera no seu painel.

- **Autenticação**: Authorization: Bearer spk_…
- **Cota**: 60 requisições por minuto por chave; diante de um 429, Retry-After.
- **Erros**: Problem Details (RFC 9457), com onze tipos documentados.
- **Contrato**: OpenAPI 3.1, com playground na documentação.
- **surface**: `pdp` · `cart` · `carousel` · `in-checkout` · `success-page`

É uma agência? A mesma integração em cada loja, com uma chave por loja. [Conheça o programa para agências](https://crossup.ai/pt/agencias)

- [Referência da API](https://docs.crossup.ai/pt/api/introduccion)

## O seu agente integra. Você revisa o diff.

Entregue ao Claude, ao Cursor ou ao Codex a sua chave de storefront e a documentação: ele verifica a chave, escreve o snippet e testa uma recomendação e um sinal. É seguro: a chave de storefront é pública e limitada.

1. **llms.txt** — Toda a documentação em um arquivo, escrita para modelos. https://docs.crossup.ai/llms.txt
2. **A skill de integrador** — O percurso de integração com as suas verificações, em um arquivo que você deixa no seu repositório. https://docs.crossup.ai/pt/agentes/skill
3. **A evidência** — Um decision_id e um signal_id com status accepted: a mesma prova que você pediria a uma pessoa. https://docs.crossup.ai/pt/agentes/integra-con-tu-agente

**Um pedido para começar**

> Integre a CrossUp na página de produto desta loja. Chave de storefront: spk_… · connection_id: cn_… · Documentação: https://docs.crossup.ai/llms.txt. Quando terminar, me mostre o decision_id de uma decisão de teste e o signal_id aceito.

- [Integre com o seu agente](https://docs.crossup.ai/pt/agentes/integra-con-tu-agente)

## Tudo o que você precisa para integrar a CrossUp.

Guias, referência da API com playground e novidades, escritos para pessoas e para agentes. Em português, espanhol e inglês.

- [Explore a documentação](https://docs.crossup.ai/pt/introduccion)
- [Conecte o SalesPilot ao Claude](https://docs.crossup.ai/pt/agentes/salespilot-en-claude)

---

[Início](https://crossup.ai/pt) · HTML: https://crossup.ai/pt/desenvolvedores