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

# Jornada do número

> Veja como a preparação, o pareamento, o aquecimento e a campanha se encadeiam no piloto.

> [!NOTE]
>
> Ações em piloto fechado, sujeitas às permissões da conta e à disponibilidade do serviço. Use a [consulta de chips](https://docs.readyzap.com.br/mcp/consultas.md) para começar com uma chave de leitura.

## Da preparação à campanha

1. **Escolha o número.** Se já tem um WhatsApp, comece pelo seu número. Se precisar de uma ativação, consulte a cotação e a disponibilidade antes de decidir. Uma ativação temporária por SMS tem prazo próprio. Uma oferta de linha renovável depende de disponibilidade e de condições próprias.
2. **Confirme a conexão.** Em conta nova, conclua o cadastro no WhatsApp. Depois, para vincular a conta ao ReadyZap, escolha QR ou código de pareamento e confirme no WhatsApp. Se a tentativa expirar, continue a mesma jornada e gere outro QR ou código.
3. **Acompanhe o aquecimento.** A preparação pode seguir no servidor após a conexão e a autorização da etapa. Consulte o estado e veja se o número já pode ser vinculado ao Disparador.
4. **Revise a campanha.** Com o vínculo elegível, prepare o texto para contatos que autorizaram mensagens. Confira o número de origem, o público e a mensagem. O envio tem autorização separada. Consulte o status antes de repetir qualquer pedido de envio.

## Experimente preparar um rascunho

> Mostre os recursos da minha conta. Prepare um rascunho para conectar meu número, com QR como opção de pareamento, e me diga o que preciso confirmar para iniciar.

Você pode acompanhar uma preparação autorizada pelo painel. Se fechar a conversa, o servidor continua as etapas que já podem rodar e aguarda você quando chegar a uma confirmação. Termos, PIN e verificações de segurança do WhatsApp são tratados pelo titular.

## Ferramentas do piloto

| Etapa | Ferramentas | Efeito |
| - | - | - |
| Cotar | `quote_marketplace_item` | Consulta preço e disponibilidade. |
| Preparar e acompanhar | `prepare_whatsapp_workflow`, `get_whatsapp_workflow` | Cria um rascunho e consulta o andamento pelo ID. |
| Iniciar ou pausar | `start_whatsapp_workflow`, `pause_whatsapp_workflow` | Inicia as etapas autorizadas ou interrompe novas etapas da preparação. |
| Parear | `prepare_whatsapp_connection`, `whatsapp_connection_qr`, `whatsapp_connection_code` | Prepara a tentativa e disponibiliza QR ou código para confirmação do titular. |
| Usar o número no Disparador | `link_warmer` | Solicita o vínculo de um chip elegível. |
| Preparar e disparar | `prepare_campaign`, `start_campaign` | A preparação cria o rascunho. O início da campanha é outra operação e exige autorização. |

Se o assistente perder a resposta, peça que consulte o ID da preparação, do pedido ou da campanha antes de tentar de novo. [Permissões e solução de problemas](https://docs.readyzap.com.br/mcp/permissoes.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.