Do zero ao primeiro envio
Um caminho curto e verificável para integrar seu sistema, sem depender de linguagem ou framework.
1Obtenha sua AuthKey
No painel AutomatizAIPRO, abra a área WhatsApp e localize AuthKey. Uma empresa pode ter uma AuthKey ativa. Se a chave já existir, use a opção de visualizar/copiar; não revogue uma chave em uso por outros sistemas.
Configure AUTOMATIZAIPRO_AUTHKEY como variável de ambiente no seu servidor. Não coloque a chave no repositório, na URL, em logs, em um aplicativo móvel distribuído ou no JavaScript entregue ao navegador.
2Encontre ou crie uma instância
Execute list para descobrir instâncias e limites. Se precisar criar uma nova, use create-instance e guarde instance.id e instance.instance_name retornados.
instance_id é o UUID do CRM; appkey é o nome da instância. O ID numérico de um dispositivo no seu banco não substitui esses identificadores.
3Conecte seu WhatsApp
Use connect para obter o QR Code ou pair-phone para iniciar a vinculação por código. No telefone, abra WhatsApp → Aparelhos conectados.
A criação e a obtenção do QR não confirmam conexão. Consulte status com um intervalo moderado até obter connected=true. Proteja o QR e o código temporário como credenciais.
4Envie para um destino controlado
Abra Enviar texto e botões e escolha sua linguagem. Use instance_id, require_instance=true e phone com DDI, DDD e número. O telefone ilustrativo deve ser substituído por um contato autorizado para seu teste.
Confira o HTTP, success, data.sent e data.total. Salve send_id e request_id no seu registro operacional, sem registrar a AuthKey. Sucesso de aceitação não é comprovação de entrega ou leitura no aparelho.
5Integre o tratamento de falhas
Use o guia de erros, defina timeout e não repita um envio automaticamente depois de uma resposta ambígua. Uma requisição que terminou com timeout pode já ter sido processada.
Para agendar, guarde schedule_id/hash e consulte schedule-status-bulk. Só marque a ocorrência como concluída ao receber completed; pending significa apenas que foi cadastrada.