Como Criar Cadastro na Uzapi

Ao acessar a plataforma, escolha uma das opções de login:

• Cadastro com e-mail
• Login com Google

Cadastro com e-mail

Para criar sua conta com e-mail:

1. Preencha todos os campos obrigatórios
2. Aceite os termos de uso
3. Finalize o cadastro

Login com Google

Para entrar com sua conta Google:

1. Faça login com sua conta Google
2. Informe:
   • Nome de usuário (username)
   • Número de WhatsApp
3. Insira o código de verificação enviado

Login com Google

Para entrar com sua conta Google:

1. Faça login com sua conta Google
2. Informe:
   • Nome de usuário (username)
   • Número de WhatsApp
3. Insira o código de verificação enviado

Descrição:
O onboarding nos ajuda a entender melhor nossos clientes, seus segmentos de atuação e o perfil do público atendido.

Dados da empresa

Preencha corretamente:

• Segmento de atuação da empresa
• Perfil dos seus clientes
• Tamanho da empresa
• Como conheceu a plataforma

Como você pretende usar a Uzapi

Informe:

• Seu objetivo principal com a plataforma
• Funcionalidades mais importantes para seu uso
• Principais atividades realizadas no dia a dia
• Tipo de mensagens que deseja enviar

Perfil dos seus clientes

• Segmentos atendidos
• Principais dores e necessidades

Explorando o Dashboard da Plataforma

Descrição:
O Dashboard é a página inicial da plataforma, onde você encontra um resumo completo das principais informações da sua conta e das suas instâncias. Ele permite acompanhar dados importantes de forma rápida e centralizada.

A seguir, veja os principais indicadores disponíveis:

1. Número de instâncias contratadas

Descrição:
Exibe o total de instâncias contratadas no seu plano, incluindo quantas estão ativas e em uso no momento.

2. Números conectados

Descrição:
Mostra a quantidade de números de WhatsApp atualmente conectados à plataforma através das instâncias ativas.

3. Status da assinatura

Descrição:
Informa a situação atual da sua assinatura, como:

• Ativa
• Teste
• Cancelada

Esse indicador é importante para garantir que seus serviços estejam funcionando corretamente.

4. Mensalidade

Descrição:
Apresenta o valor atual do seu plano contratado, permitindo fácil visualização dos custos recorrentes da plataforma.

5. Status das instâncias

Descrição:
Exibe o status detalhado de todas as instâncias cadastradas, como:

• Conectada
• Desconectada
• Aguardando autenticação

Esse painel ajuda no monitoramento e na gestão das conexões com o WhatsApp.

Dicas de Uso do Dashboard

• Acesse o Dashboard regularmente para acompanhar o status das suas instâncias
• Verifique se todas as conexões estão ativas para evitar falhas no envio de mensagens
• Monitore sua assinatura para evitar interrupções no serviço

Meu Perfil

Como acessar o perfil

1. No menu lateral, clique no ícone de navegação.
2. Selecione a opção Meu Perfil.

Informações disponíveis

Na tela Meu Perfil, é possível visualizar as seguintes informações da conta:

• Nome de usuário (Username);
• Número do WhatsApp vinculado à conta;
• Endereço de e-mail utilizado no cadastro.

Observação

As informações exibidas nessa tela correspondem aos dados cadastrados na conta e podem ser utilizadas para identificação e gerenciamento do acesso à plataforma.

Como Contratar, Fazer Upgrade e Downgrade de Instâncias na Uzapi

Descrição:
Nesta seção, você aprenderá como contratar novas instâncias, além de realizar upgrade ou downgrade do seu plano de forma automática dentro da plataforma Uzapi.

1. Como contratar novas instâncias

Siga o passo a passo abaixo para contratar novas instâncias:

1. No menu lateral, clique em Contratar instância
2. Selecione o plano desejado
3. Informe a quantidade de números/instâncias que deseja contratar
4. Clique em Contratar agora
5. Preencha os dados solicitados
6. Escolha o tipo de cobrança
7. Clique em Pagar primeira mensalidade
8. Selecione a forma de pagamento
9. Preencha os dados e confirme o pagamento

2. Como fazer upgrade de plano

O upgrade permite aumentar a quantidade de instâncias ou mudar para um plano superior.

1. No menu lateral, clique em Contratar instância
2. Selecione a nova quantidade de números/instâncias desejadas
3. Clique em Contratar agora
4. Escolha o tipo de cobrança
5. Clique em Pagar

Observação:
Será gerado um novo boleto com o valor proporcional referente à diferença entre o plano atual e o novo plano.

6. Selecione a forma de pagamento
7. Preencha os dados e confirme o pagamento

3. Como fazer downgrade de plano

O downgrade permite reduzir a quantidade de instâncias contratadas.

1. No menu lateral, clique em Contratar instância
2. Selecione a nova quantidade de instâncias desejadas (menor que a atual)
3. Clique em Contratar agora

Observação:

• Será calculada a diferença entre o plano atual e o novo plano
• Caso haja redução de valor, será gerado um crédito automaticamente
• Esse crédito poderá ser utilizado na próxima fatura

Dicas importantes

• Revise a quantidade de instâncias antes de confirmar a contratação
• Utilize upgrade para escalar sua operação rapidamente
• Utilize downgrade para otimizar custos quando necessário

Instância de WhatsApp: Como Criar e Gerenciar

Após o cadastro, você recebe um teste gratuito com direito a uma instância por 7 dias para testar a integração com WhatsApp.

O que é uma instância?

Uma instância é a conexão entre a plataforma e o seu WhatsApp, permitindo envio e automação de mensagens.

Como criar uma instância

1. Acesse o dashboard
2. Clique em Nova Instância
3. Preencha:
   • Nome da instância
   • Webhook (opcional)
   • Método de autenticação:
     • QR Code
     • Pairing Code (com número de WhatsApp)
4. Vá em Opções > Autenticação
5. Escaneie o QR Code com seu WhatsApp

1 Como atualizar uma instância

1. Clique em Opções
2. Selecione Atualizar instância

1.1 Como excluir uma instância

1. Clique em Opções
2. Clique em Deletar instância
3. Confirme em Excluir

1.2 Como reconectar uma instância

Se a conexão cair:

1. Clique em Opções
2. Clique em Desconectar instância
3. Clique em Autenticar
4. Escaneie o QR Code novamente

1.3 Como configurar webhook da instância

O webhook permite integrar eventos com outros sistemas.

1. Clique em Opções
2. Acesse Visualizar instância
3. Vá em Configurações
4. Insira a URL do webhook
5. Clique em Atualizar

1.4 Como visualizar uma instância

1. Clique em Opções
2. Clique em Visualizar instância

Como criar um novo ticket de suporte

1. No menu lateral, clique em Suporte.
2. Na tela de suporte, clique em Adicionar Novo Ticket.
3. Selecione a categoria correspondente ao seu chamado.
4. Defina a prioridade do atendimento.
5. Preencha as informações necessárias e envie o ticket

Observações

• Todos os registros e interações do atendimento ficam disponíveis no histórico do ticket.
• Novas informações ou respostas da equipe de suporte serão adicionadas diretamente ao chamado.
• Recomenda-se acompanhar periodicamente o ticket para verificar atualizações e responder às solicitações da equipe de suporte, quando necessário.

Acompanhamento de Tickets

Como acompanhar um chamado em andamento

1. No menu lateral, clique em Suporte.
2. Na tela de suporte, localize o ticket que deseja acompanhar.
3. Selecione o ticket desejado.
4. Consulte o histórico de mensagens para acompanhar toda a comunicação e o andamento do atendimento.

Observações

• Todos os registros e interações do atendimento ficam disponíveis no histórico do ticket.
• Novas informações ou respostas da equipe de suporte serão adicionadas diretamente ao chamado.
• Recomenda-se acompanhar periodicamente o ticket para verificar atualizações e responder às solicitações da equipe de suporte, quando necessário.

Testando a API

Acesse o guia de referência da API para explorar e testar todos os endpoints disponíveis.

Documentação da API:
https://api.uzapi.com.br/docs

Swagger:
https://api.uzapi.com.br/swagger

Enviando uma mensagem

Endpoint

POST {{baseUrl}}/:username/:version/:phone_number_id/messages

Obtendo os parâmetros da API

Antes de realizar a requisição, acesse o painel da sua instância e obtenha os seguintes parâmetros:

Configurando a autenticação

A API utiliza autenticação do tipo Bearer Token.

No Postman, crie uma variável de ambiente:

Nome: token

Valor:

eyJhbGcxxxxxx

Em seguida, na aba Authorization da requisição, selecione:

Type: Bearer Token
Token: {{token}}

Testando o endpoint /messages

Corpo da requisição

{
  "to": "55219xxxxxxxx",
  "delayMessage": 0,
  "delayTyping": 0,
  "type": "text",
  "text": {
    "body": "Olá Mundo!"
  }
}

Exemplo de resposta

{
  "status": "success",
  "message": "Mensagem colocada na fila de envios com sucesso!",
  "queueId": "BB3A206B22B97B70E3E2F74197747CB3",
  "messageId": "3EB033430E4C1324B0E016",
  "contacts": [
    {
      "input": "5521xxxxx",
      "wa_id": "5521xxxxx"
    }
  ],
  "messages": [
    {
      "id": "wamid.PXpweDEvZWtnZTZ6Tk1rVFNFOGxZaVIzVnVyT1ZMclhUcHhVdUM9Nw=="
    }
  ]
}

Descrição da resposta

Quando a requisição for processada com sucesso, a mensagem será adicionada à fila de envio e os identificadores retornados poderão ser utilizados para rastreamento e auditoria.