# Grapnel

> Um link para toda a sua equipe no WhatsApp.

Distribua os contatos entre seus vendedores e acompanhe as conversas de cada campanha. O atendimento continua no WhatsApp.

A Grapnel é uma plataforma para equipes que vendem e atendem pelo WhatsApp. Um único link direciona o contato para o número de um vendedor. No painel, você organiza os números conectados e acompanha cliques e conversas atribuídas às campanhas.

Esta é uma versão em Markdown das informações públicas da [página inicial da Grapnel](https://grapnel.com.br/).
Inclui também um resumo da [API pública](https://grapnel.com.br/docs); o contrato detalhado está no [OpenAPI JSON](https://grapnel.com.br/docs/openapi.json).

## Recursos

### Distribuição de contatos

Compartilhe um único link para vários números. Escolha quais vendedores recebem os contatos e a proporção de distribuição entre eles. É possível manter o vínculo do visitante com o atendente, conforme a identificação disponível, e definir um número alternativo para quando não houver conexões disponíveis.

### Gestão de números

Conecte seus números pelo QR Code e veja quais WhatsApps estão conectados. Use nomes e etiquetas para organizar vendas, suporte e equipes. Cada conexão corresponde a um número de WhatsApp.

#### Avisos de desconexão

Em uma desconexão inesperada, com os alertas ativados, o proprietário recebe um e-mail que identifica a instância e inclui um link para acessar o painel e reconectar o número escaneando um novo QR Code. O envio segue as preferências de notificação da conta.

### Campanhas e conversas

Acompanhe cliques, contatos e conversas atribuídas às campanhas. Uma conversa é atribuída quando uma mensagem recebida pode ser vinculada ao clique rastreado. Configure Meta Pixel, Google Ads e API de Conversões no seu fluxo. O rastreamento e a atribuição dependem da configuração das integrações e da identificação disponível.

Uma conversão em conversa não significa uma venda concluída.

### Integrações e automações

Você conecta números e configura links pelo painel, sem precisar programar. Sua equipe continua atendendo pelo WhatsApp.

Para desenvolvedores, a API permite integrar links, contatos, métricas e WhatsApp a sistemas externos. Os webhooks de atribuição são opcionais. A configuração dos bots e dos fluxos de atendimento é feita na ferramenta de automação utilizada pela equipe.

#### Exemplos de uso com sistemas externos

- **Pedidos e entregas:** envie pelo WhatsApp atualizações de pedidos a partir da sua loja ou sistema de gestão.
- **Lembretes e cobranças:** envie avisos de agendamentos e vencimentos nos horários definidos pelo seu sistema.
- **Atendimento automatizado:** conecte bots externos para responder perguntas e encaminhar o contato para sua equipe.
- **Pós-venda:** envie orientações ou pesquisas após o atendimento, conforme o fluxo da sua ferramenta.

Esses fluxos usam a API e ferramentas externas. Os gatilhos, horários e regras são configurados no sistema externo; a Grapnel não oferece um construtor nativo dessas automações.

### API v1

A API Grapnel integra links, analytics, leads e WhatsApp a sistemas externos. Cada chave acessa somente os recursos da própria conta e as permissões concedidas. A autenticação usa `Authorization: Bearer`; alterações exigem `Idempotency-Key`. Mantenha as chaves exclusivamente no servidor.

- [Documentação da API em Markdown](https://grapnel.com.br/docs.md): autenticação, início rápido, idempotência, erros e lista de operações.
- [Documentação Swagger](https://grapnel.com.br/docs): geração e revogação de chaves, exemplos e testes interativos.
- [OpenAPI JSON](https://grapnel.com.br/docs/openapi.json): contrato com campos, exemplos, permissões e respostas de cada operação.

## Como funciona

1. **Conecte seus números:** crie e confirme sua conta, escolha um plano e escaneie o QR Code pelo WhatsApp de cada número.
2. **Monte o link da equipe:** escolha os números que recebem os contatos e configure a distribuição.
3. **Compartilhe seu link:** use nos anúncios, na bio ou no site. Acompanhe os cliques e as conversas atribuídas pelo painel.

A [demonstração na página inicial](https://grapnel.com.br/#demonstracao) é uma prévia ilustrativa com dados de exemplo.

## Contratação

Cada conexão corresponde a um número de WhatsApp. A contratação é por quantidade de conexões, com plano mensal ou anual. O pagamento é recorrente no cartão, pelo Stripe. Depois de criar e confirmar a conta, o usuário escolhe a quantidade e o plano no painel; criar a conta não exige cartão. O proprietário da conta pode gerenciar as assinaturas e cancelar a renovação em Pagamentos, no painel, ou com ajuda do suporte pelo WhatsApp.

Consulte os valores atuais na [seção de planos](https://grapnel.com.br/#planos) e as condições apresentadas no painel ao contratar.

## Perguntas frequentes

### Preciso saber programar?

Para conectar números e configurar links pelo painel, não. A API e os webhooks ficam disponíveis para quem deseja integrar sites, bots e outros sistemas.

### Posso usar os números de WhatsApp que já tenho?

Sim. A conexão é feita por QR Code, usando a opção Aparelhos conectados do WhatsApp. Cada conexão corresponde a um número.

### Como os contatos são distribuídos entre os vendedores?

Você reúne os números em um link, escolhe quais vendedores participam e configura a proporção de contatos para cada um. O vínculo com o atendente depende da identificação disponível. Também é possível configurar um número alternativo para quando não houver conexões disponíveis.

### A Grapnel acompanha vendas ou conversas?

O painel acompanha cliques, contatos e conversas que podem ser vinculadas aos cliques rastreados. Essa métrica não representa uma venda concluída. A atribuição depende da configuração das integrações e da identificação disponível.

### Posso conectar bots e outras ferramentas?

Sim, por API e webhooks. Os bots e fluxos de atendimento são configurados na ferramenta de automação que a equipe utiliza.

### Quanto custa e posso cancelar?

O valor depende da quantidade de conexões e do período, mensal ou anual; os valores atuais estão na [seção de planos](https://grapnel.com.br/#planos). Após criar e confirmar a conta, escolha a quantidade e o plano no painel. O pagamento recorrente é feito no cartão pelo Stripe, e a renovação pode ser cancelada em Pagamentos ou com ajuda do suporte pelo WhatsApp. As condições de cancelamento e arrependimento estão nos [Termos de uso](https://grapnel.com.br/termos).

## Acesso

- [Criar conta](https://grapnel.com.br/register)
- [Entrar na Grapnel](https://grapnel.com.br/login)

## Outros formatos

- [Página inicial em HTML](https://grapnel.com.br/)
- [Guias de WhatsApp e campanhas](https://grapnel.com.br/guias): distribuição de contatos, rastreamento e conexões.
- [Guias em Markdown](https://grapnel.com.br/guias.md)
- [Índice para agentes](https://grapnel.com.br/llms.txt)
- [Mapa de conteúdo público](https://grapnel.com.br/sitemap.md)
