Introdução
Este tutorial reúne o passo a passo essencial para começar a usar o SompZap: desde o primeiro acesso até a integração via API. Para dúvidas específicas de cada módulo, consulte também a Central de Ajuda dentro do painel, com vídeos e materiais complementares.
Primeiro acesso
Acesse a tela de login com o e-mail e senha cadastrados no momento da criação da conta.
- Acesse
/auth/login. - Informe e-mail e senha.
- No primeiro acesso, complete os dados da empresa em Configurações → Perfil.
Como criar instâncias
Instâncias representam cada canal de atendimento (um número de WhatsApp, por exemplo).
- Acesse o menu Canais.
- Clique em Nova instância.
- Escolha o tipo de canal e dê um nome de identificação.
Como conectar o WhatsApp
Depois de criar a instância, é preciso parear o número de WhatsApp com a plataforma.
- Na lista de Canais, clique em Conectar.
- Escaneie o QR Code exibido com o WhatsApp do celular (Aparelhos conectados).
- Aguarde o status mudar para Conectado.
Como utilizar Webhooks
Webhooks permitem que o sistema notifique automaticamente uma URL externa quando eventos acontecem (nova mensagem, status de campanha, etc).
- Configure webhooks de saída no módulo Workflow, usando o nó de Webhook.
- Cada requisição enviada inclui um payload em JSON com os dados do evento.
Como utilizar a API
A API permite enviar mensagens e consultar dados da conta a partir de sistemas próprios.
- Todas as requisições usam a base
/api/v1/. - Autenticação via cabeçalho
Authorization: Bearer SEU_TOKEN. - Respostas em formato JSON.
Como gerar um Token
Tokens de API são gerados e gerenciados dentro do próprio painel.
- Acesse Configurações → Tokens de API.
- Clique em Gerar novo token e dê um nome de identificação.
- Copie o token exibido — por segurança, ele não é mostrado novamente depois.
Perguntas frequentes (FAQ)
Posso conectar mais de um número de WhatsApp?
Sim. O número de instâncias simultâneas disponíveis depende do plano contratado — veja o limite atual em Configurações → Consumo.
O que acontece se eu desconectar o WhatsApp por engano?
Basta acessar o canal novamente em Canais e escanear um novo QR Code para reconectar — nenhuma configuração de automação é perdida.
Como sei se meu token de API ainda é válido?
Tokens não expiram automaticamente, mas podem ser revogados a qualquer momento em Configurações → Tokens de API. Um token revogado deixa de autenticar novas requisições imediatamente.
Onde encontro mais vídeos e materiais de apoio?
Na Central de Ajuda, disponível no menu do painel, com vídeos tutoriais e materiais em PDF organizados por assunto.