PABX/GupShup
De uTech Tecnologia
Tabela de conteúdo |
- Antes de começar, é necessário ter uma conta ativa e verificada do Facebook Business.
- Os números NÃO devem estar associados ao outros aplicativos (Outros parceiros de API do Whatsapp ou Whatsapp Business APP)
- Necessário instalar um certificado digital no PABX, pois as conexões DEVEM ser HTTPS. (Como instalar um certificado no PABX - Utilize o site https://www.sslforfree.com para criar um certificado e testar a conexão HTTPS.)
|
Qualquer dificuldade em criar a sua conta no Gupshup, ou associar o número desejado de telefone à sua conta da API Business, é possível entrar em contato diretamente com o broker através do e-mail devsupport@gupshup.io . |
Configurando seu número no GupShup
|
IMPORTANTE!!!: Gostaria de saber qual o processo para retirar o número da Gupshup e devolver ao whatsapp business original (celular) e se existe alguma orientação adicional para não haver problemas.
|
- Acesse www.gupshup.io e crie uma conta.
- Depois de criar sua conta, é necessário inserir um novo App. Acesse a plataforma GupShup e vá até Dashboard e depois Whatsapp. Depois clique no ícone + para adicionar, conforme imagem abaixo:
| NOTA: Para cada número deverá ser criado um novo App na plataforma do Gupshup. |
- Selecione a opção Access API, conforme imagem abaixo:
- Insira o nome da sua aplicação, e clique no botão Submit, conforme imagem abaixo. Sua aplicação será criada e mostrada no Dashboard(Colocar o número do telefone que será associado ajuda na identificação, caso o cliente tenha diversos números):
- Depois de criada a aplicação, é necessário configurar as URL's de callback da API, para que o PABX receba as mensagens (Este passo pode ser deixado para o final, caso o cliente ainda não tenha o PABX configurado, bem como a URL para callback). No menu Dashboard/Whatsapp, clique no botão Settings e depois selecione a opção Callback URL / Link your Bot e insira a URL de acesso ao PABX uTech, conforme imagens abaixo:
|
NOTAS:
Exemplos:
|
- Depois de configurar a URL de callback, volte para o menu Dashboard/Whatsapp e clique no botão Go Live do aplicativo desejado, para associar um número a este aplicativo, conforme imagem abaixo:
- PASSO 1': Selecione o pais de origem.
- PASSO 2': Configure os dados da Empresa.
- PASSO 3: Verifique e confirme se os dados da empresa estão corretos.
- PASSO 4: Insira o ID da sua conta do Facebook Business. O ID Copie e cole, conforme imagens abaixo. Insira também o número que deseja associar a esta aplicação. (Ou acesse o menu Configurações do Negócio ⇐ Informações da Empresa e verifique o ID no campo Número de identificação do Gerenciador de Negócios.
- No mesmo PASSO 4, Insira nome 'comercial' da empresa. Este nome deve seguir sempre as orientações do Facebook.
|
NOTA: Muito importante ficar atento aos requisitos do Display Name, caso contrário, o mesmo poderá ser rejeitado pelo Facebook. Abaixo, na próxima imagem é mostrado algumas dicas e exemplos. Veja tambe o link Display Name com a documentação do Facebook. |
- No mesmo PASSO 4, deverá ser confirmado no Facebook Business, a permissão de acesso a plataforma GupShup. Acesse o Facebook Business, em Configurações do Negócio, menu Solicitações e depois Recebidos. Nesta tela irá aparecer uma mensagem para aprovar o GupShup como 'parceiro' para envio de mensagens, conforme imagem abaixo.
- Depois de Aprovar, volte para o PASSO 4 do Gupshup e clique no botão I have approved, conforme imagem abaixo:
- PASSO 5 Agora, basta esperar que o Facebook/Whatapp aprove seu cadastro/número.
NOTA:: Você receberá um e-mail com aprovação ou reprovação (necessário rever os dados cadastrados). Ou pode verificar acessoando a plataforma do GupShup no menu Dashboard / Whatsapp e verificar o status de cada número inserido.
Configurando o PABX uTech
Acesse o menu GESTÃO ⇒ Configurações ⇒ Integrações ⇒ Gupshup.
- Insira no campo Token o Gupshup API Key. Este valor DEVE ser buscado na interface de gerenciamento do Gupshup. Conforme imagem exemplo abaixo (Pressionar o logo/ícone da conta no canto superior direito):
- Acesse a aba Contas e adicione uma nova conta, conforme imagem abaixo:
- Nome da Aplicação: Nome da aplicação, conforme descrito na interface de gerenciamento do Gupshup.
- Conta:: Número a ser utilizado no whatsapp para enviar e receber mensagens no formato E.164 (Com +55)
- Ramal, Fila, Mensagem Interativa, Chatboot, Consulta Número: Escolha um desses campos para selecionar para onde serão encaminhadas as mensagem recebidas no número do whatsapp configurado.
Como criar um novo Modelo/Template
Ler antes: Message Template Guidelines
- Passo 1: Acesse sua conta do Gupshup em https://www.gupshup.io. Acesse Dashboard ⇒ WhatsApp. Escolha o app (onde está cadastrado o WhatsApp que você irá utilizar) e clique em Settings.
- Passo 2: Localize a opção View templates e clique sobre esta opção.
- Passo 3: Clique no botão Add More para adicionar um novo.
- Passo 4: Será aberto um formulário para preencher os dados do template:
- Preencha os dados do formulário, que será enviado para aprovação do Whatsapp:
- Template Labels - Etiquetas de modelo: informe qual a utilização desta mensagem. DEVE inserir entre duas ou três palavras. Ex.: Confirmação de consulta, etc.
- Template Category - Categoria do modelo: Selecione uma opção de categoria para seu template.
- MARKETING: Para enviar ofertas promocionais, anúncios de produtos e mais a fim de aumentar a conscientização e o engajamento.
- SENHAS DE USO ÚNICO (OTP) - Para enviar códigos que permitem aos clientes acessar suas contas com segurança.
- TRANSACIONAIS: Para enviar atualizações sobre contas ou pedidos, alertas e outras informações importantes.
- Template Type - Tipo de modelo: Defina o conteúdo da mensagem (Text).
- Template Language - Idioma do Modelo: Selecione o idioma que a mensagem utilizará.
- Element Name - Nome do elemento: Nome do template. Deve corresponder a mensagem/template. Se seu template for de confirmação de consultas, por exemplo, coloque algo como confirmacao_de_consultas. O nome precisa ser alfanumérico, minusculo e conter sublinhado ( _ ) no lugar dos espaço.
- Template Format - Formato do modelo: Neste campo, deverá ser definido o modelo da mensagem que será enviada para os usuários. O Template / modelo DEVE seguir as regras definidas pelo Whatsapp. Os textos personalizados devem seguir o padrão de uma variável, como {{N}}, onde N será o número sequencial da variável substituída.
Exemplo:
Olá {{1}}, o horário da sua consulta está marcado para {{2}}. Responda com a palavra Sim para confirmar ou Não para cancelar.
- Add interactive actions:: Selecione none ou nenhum.
- Sample message - Exemplo de mensagem: Insira um exemplo de mensagem enviada:
Olá [Marcio Silva], o horário da sua consulta está marcado para [01/01/1070 as 15h:30]. Responda com a palavra Sim para confirmar ou Não para cancelar.
- Clicar em Preview and Submit para enviar a solicitação de aprovação do template/modelo.
- Quando aprovado, seu template/modelo será exibido como mensagem aprovada (ou rejeitada), conforme mostrado abaixo:
|
Verifique se o envio de templates está habilitada para esete app/número. Na opção Settings do número em questão, verifique se o campo Template Messaging em Manage your Template messaging settings está habilitado. Conforme imagem abaixo:
 |
No PABX
- Passo 1: Crie o template acessando o menu CALL CENTER ⇒ Templates. Adicione o template conforme informado e aprovado pelo Whatsapp e selecione a opção HSM como Sim, conforme exemplo abaixo:
- Passo 2: Acesse o CTIWeb e clique no botão de Templates e selecione o template/modelo configurado.
Trocar foto (e dados) do Perfil
- Para trocar a foto do perfil da conta/número do Whatsapp, solicite para o administrador ou ao responsável para acessar a conta do Gupshup em https://www.gupshup.io/.
- Depois, acesse o menu Dashboard => Whatsapp => Profile Settings, conforme mostrado na imagem abaixo:
- Clique na imagem antiga e selecione a nova imagem, conforme mostrado da imagem abaixo:
Mensagens Interativas
O Whatsapp permite o envio de 2 opções de mensagens interativas:
- Quick Replay
- Mesage List
Quick Replay / Respostas Rápidas
Esse tipo de mensagem oferece uma maneira mais rápida de os usuários fazerem uma seleção em um menu ao interagir com uma empresa. Os botões de resposta têm a mesma experiência do usuário que os modelos interativos com botões.
- Máximo 3 opções.
- Título dos botões não podem ser "vazios" e devem ter um texto único para cada botão. Maximo 20 caracteres por botão. Não aceito emojis e formatações.
- Titulo/texto inicial DEVE ter, no máximo, 20 caracteres.
- Rodapé DEVE ter, no máximo, 60 caracteres.
Formato:
Texto inicial | Cabeçalho | OPÇÕES | Rodapé
- O campo opções contem os botões que serão mostrados na mensagem e o texto de cada botão DEVE estar entre colchetes. Cada botão tambem DEVE ser separado pelo caractere pipe (|).
- Texto inicial | Cabeçalho | [Opção1] | [Opção2] | [Opção3] | Rodapé
Exemplo da imagem ao lado:
- Bem vindo a uTech | Selecione uma opção: | [Comercial] | [Suporte] | [Financeiro] | Para sair digite #sair
- Outro exemplo:
Formato: Bem vindo a SaúdeTech | Selecione período que desejada | [Manhã] | [Tarde] | [Indiferente] | Escolha indiferente para horários de manha e tarde.
List Mesages / Lista de Mensagens
Mensagens incluindo um menu de até 10 opções. Esse tipo de mensagem oferece uma maneira mais simples e consistente para os usuários fazerem uma seleção ao interagir com uma empresa.
- Título DEVE ter no máximo 60 caracteres.
- Cabeçalho DEVE ter no máximo 1024 caracteres.
- Máximo 10 opções.
Formato:
- Titulo | Cabeçalho | Titulo do Botão | OPÇÕES
- Onde OPÇÕES DEVE ser: (Título,Descrição).
- O campo OPÇÕES possui a lista de opções que serão mostradas na mensagem. Cada item da lista de opções possui um título e uma breve descrição de cada opção. Exemplo: (OPÇÃO1) | (OPÇÃO 2).
- Cada opção DEVE estar entre parentreses. E cada opção DEVE ter um título de uma descrição, separados pelo caractere virgula (,). Ex. (Comercial,Falar com um vendedor) | (Suporte,Suporte técnico).
Exemplo da imagem ao lado:
- Bem vindo a uTech | Selecione uma das opções | Opções | (Comercial,Falar com um vendedor) | (Suporte,Suporte técnico) | (Financeiro, Contas a pagar) | (Compras,Contas a receber) | (Receção,Nenhum das opções)
Verificando Saldo e Adicionando Créditos
Verificando Saldo da Conta
Para verificar o saldo de sua conta no Gupshup, acesse o PABX uTech, menu GESTÃO ⇒ Configuração. Clique na aba Integrações e depois Guphsup. Depis clique no botão Carteira. Nesta tela será mostrado o saldo de sua conta no Gupchup, conforme imagem abaixo:
- NOTA: Saldo apresentado em dólares.
Adicionando Créditos a Conta do Gupshup
Para adicionar créditos, acesse https://www.gupshup.io/ e siga os passos abaixo:
- Passo 1: Acesse o portal do Gupshup e selecione a opção Whatsapp e depois My Wallet1, como mostrado na imagem abaixo:
- Passo 2: Clique no botão Add Balance, como mostrado na imagem abaixo:
- Passo 3: Selecione o valor que deseja adicionar (em dólares), preencha os dados cadastrais para que serão inseridos na Invoice e clique no botão Recharge, como mostrado na imagem abaixo:
- Passo 4: Selecione uma das opçoes de pagamento (clicando na opção). EBANX ou Stripe. Normalmente e recomentado a utilização da opção EBANX. As opções serão mostradas como na imagem abaixo:
- Passo 5: Preencha os dados cadastrais do pagador. Depois selecione uma opção de pagamento e clique no botão Pagar com ...., coonforme imagem abaixo:
- Depois de finalizar a opração, volte para o pabx e verifique o saldo. A opração pode demorar alguns minutos.
