WhatsApp Gupshup

https://integra-scm.atlassian.net/l/c/qfuptKeA

Configurar Gupshup no uContact é um processo simples, mas primeiro verifique se você tem tudo o que é necessário para criar um provedor e uma campanha.

1. Configurar a conta

Os webhooks do uContact também são configurados para que o Gupshup envie as mensagens e os status para o portal.

https://<instancename>.ucontactcloud.com /Integra/resources/Gupshup/event

2. Criar um Provedor no uContact

Faça login no uContact com um usuário com permissões para criar provedores de SMS.

Em seguida, vamos para Administrator → Providers → SMS

Selecionamos Gupshup na lista de provedores e preenchemos os campos:

Nome
Para identificar o provedor.
user
Nome do App.
password
API Key do Gupshup.
sms from
Número de WhatsApp sem pontos, espaços ou sinais

3. Criar campanha

Selecionar um provedor Gupshup.
Coloque o nome do app no campo da porta.

O NGINX deve ser modificado para responder a eventos quando o URL for adicionado no Gupshup.

Para esse fim, o parágrafo a seguir deve ser adicionado ao arquivo "/etc/nginx/sites-enabled/default"

location /Integra/resources/Gupshup/ { proxy_pass

http://localhost:8085;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;}

Lista de Buttons Interativos

Tudo o que está em negrito é obrigatório

Exemplo:

Button:

image;https://integraccs.ucontactcloud.com/attachments/20211015/214bc4ec-5be3-4c03-a1e9-df2b6efa969c.jpeg;texto da imagen;legenda

1-Opção 1

2-Opção 2

3-Opção 3

Lista Interativa

Exemplo sem título de opções:

List:

button: Texto da lista de botões

body: Algum texto

header: cabeçalho

title: Título da lista

1-Opção 1 - descrição 1

2-Opção 2 - descrição 2

3-Opção 3 - descrição 3

4-Opção 4 - descrição 4

footer: rodapé

Exemplo com título para opções:

List:

button: Texto da lista de botões

body: Algum texto

header: cabeçalho

title: Título da lista

itemTitle: Título das opções "primera parte"

1-Opção 1 - descrição 1

2-Opção 2 - descrição 2

itemTitle: Título das opções "segunda parte"

3-Opção 3 - descrição 3

4-Opção 4 - descrição 4

footer: rodapé

Para poder enviar HSM's, é preciso usar uma ID. Essa ID é obtida por meio de uma solicitação HTTP.

GET https://api.gupshup.io/sm/api/v1/template/list/<app_name>
HEADERS apikey: <api_key>

O nome do aplicativo e a chave api são os mesmos parâmetros usados ao configurar um provedor Gupshup no uContact.

Templates

Os templates de mensagens podem servir como uma ferramenta valiosa para iniciar conversas com os usuários. Os templates baseados em texto podem ser acessados na janela de configuração do provedor e empregados na caixa de entrada juntamente com as respostas predefinidas. Nesse processo, é essencial substituir os espaços reservados pelos valores específicos exigidos como variáveis.

Synchronize (Sincronizar): Clicar nesse botão buscará todos os templates de tipo de texto aprovados associados à conta. Quando o processo de sincronização for bem-sucedido, os membros da campanha poderão utilizar esses templates como respostas predefinidas.

Delete (Excluir): Esse botão é usado para remover permanentemente todos os templates do provedor no uContact.

`hsm;id_template;tipo;variável;variável;variável`

`hsm;2b394c67-3ef5-4e50-b0bd-446bd5a71c4b;text;variável;variável;variável`

`hsm;id_template;tipo;mediaUrl;variável;variável;variável`

`hsm;c6aecef6-bcb0-4fb1-8100-28c094e3bc6b;image;https://images.pexels.com/photos/248797/pexels-photo-248797.jpeg;variável;variável;variável`

Contatos

contact;firstName;formattedName;phone;type;:email;type;direction;type

Ejemplo:

`contact;John:John Smith;59898514179;CELL;abc2594@gmail.com;Cufre 1940;HOME`

Location

location;longitude,latitude;Nombre;direccion

Ejemplo:

`location;-34.92403016332158, -56.158280428772684;Shopping Punta Carretas;Montevideo, Uruguay`

NGINX

Para recibir los mensajes en uContact es necesario agregar el siguiente fragmento de código a la configuración de NGINX.

location /Integra/resources/Gupshup{
     proxy_pass http://localhost:8085;
     proxy_set_header Host $host;
     proxy_set_header X-Real-IP $remote_addr;
     proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}