Versions Compared

Version Old Version 3 New Version 4
Changes made by

Rodrigo Monteiro (Voice Engineering)

Rodrigo Monteiro (Voice Engineering)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

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.

Tip

Requerido:

  • Conta configurada com acesso em Gupshup.

  • criar um App.

  • Faça login no uContact com um usuário com permissão para criar campanhas de SMS e discadores.

  • Faça loTer um IP público para redirecionar o tráfego do uContact.

  • Ativar o NGINX.

Contenido

Table of Contents
minLevel1
maxLevel2
outlinefalse
typelist
printablefalse

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:

  • Nomenome
    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

Tipo Buttons:

Note

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
Anchor
NGINX
NGINX

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

Code Block
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;
}