¶ Integração | SmartZAP V4 - Fortics
Neste módulo veremos sobre a integração de whatsapp/mensageiro SmartZAP V4 - Fortics.
¶ Parâmetros Necessários Para a Integração
Para conseguir o acesso os parâmetros, será necessário que o provedor envie ao suporte do Hubsoft:
- Usuário e Senha do tipo Agente
- URL de acesso
Ambos os dados são fornecidos pela plataforma.
Com os daods em mãos, é necessário fazer um POST na url: https://provedor.sz.chat/api/v4/auth/login e passar um JSON como o exemplo:
{
“email”:”email”,
“password”:”senha”
}
Será gerado um token no final do processo. Depois de gerado este token, é necessário gerar uma consulta do tipo GET na url: https://provedor.sz.chat/api/v4/channels com o Type ‘Bearer Token’ e colar o token gerado anteriormente no quadro.
Será gerado uma lista de canais, onde você poderá verificar qual é o número correto para envio.
Em seguida você pode copiar o _id para colar na integração no parâmetro channel_id.
Verificar qual a funcionalidade contratada pela plataforma, para conseguir pegar o ID corretamente.
¶ Integrando no Hubsoft
Para realizar a Integração, acesse o menu Configuração > Integrações > SMS/Mensageiros
Clique em Adicionar
Escolha o Gateway de SMS como SmartZAP_v4 - Fortics, preencha a Descrição e inclua os parâmetros:
Obs.: Caso seja necessário informar o usuario, senha, id ou token, basta incluí-los como parâmetros.
Após salvar, caso a integração seja com HSM, será necessário cadastrar os templates HSM.
¶ Templates HSM
Para adicionar um Template, você deverá ir em Configuração > integrações > sms/mensageiros > na integração > ações > Template HSM.
Clique em Adicionar Template
Para configurar os templates no sistema deve ser cadastrado:
- Código do Template: Deve ser colocado o nome do template
- Descrição: Inserir uma descrição para o template
- Parâmetros: Nos parâmetros deve ser cadastrado seguindo a seguinte syntaxe: ‘‘hsm_placeholders.1’’.
No exemplo abaixo, o template tem 3 variáveis/parâmetros, assim sendo no sistema ficará hsm_placeholders.1, hsm_placeholders.2 e hsm_placeholders.3.
¶ Perguntas/Problemas Frequentes
Abaixo serão listadas algumas perguntas/problemas frequentes relacionados a integração de mensageiro Fortics. Caso alguma dessas situações aconteça e você tenha dificuldades para resolver, não hesite em chamar nosso suporte, pois estamos aqui para lhe ajudar.
¶ Por que o meu template de HSM adicionado não esta funcionando?
Para o bom funcionamento dos templates cadastrados na integração é necessário que ele esteja preenchdio da forma correta conforme esta na plataforma e também o mesmo precisa estar liberado na plataforma, neste caso, se não estiver funcionando, será necessário analisar se os dados do template estão preenchidos corretamente e se na plataforma, o mesmo esta liberado para uso.
¶ Para esta integração, o usuário precisa ser do tipo agente?
Sim, o usuário e senha precisam ser do tipo agente para o cadastro da integração.