Versions Compared

Key

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

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


Configurar Gupshup en uContact es un proceso sencillo, pero primero se debe verificar que se posea todo lo requerido para crear un proveedor y campaña 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:

  • Cuenta configurada con acceso en Conta configurada com acesso em Gupshup.

  • Crear una criar um App.

  • Ingresar a uContact con un usuario con permiso para crear campañas y marcadores SMS.

  • Poseer una IP Pública para redireccionamiento de tráfico de uContact.

  • Habilitar el 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

cuentaTambién se configuran los webhooks de uContact para que Gupshup mande los mensajes y estados al

a conta


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


2.

Crear proveedor en

Criar um Provedor no uContact

Ingresa a uContact con un usuario con permisos para crear proveedores Faça login no uContact com um usuário com permissões para criar provedores de SMS.

Luego nos dirigimos a Administrador → Proveedores Em seguida, vamos para Administrator → Providers → SMS

Seleccionamos Selecionamos Gupshup de la na lista de proveedores y completamos los provedores e preenchemos os campos:

  • NombreNome
    Para identificar al proveedoro provedor.

  • user
    Nombre de la Nome do App.

  • password
    API Key de do Gupshup.

  • sms from
    Número de WhatsApp sin puntos, ni espacios, ni signos.sem pontos, espaços ou sinais


3.

Crear campañaSeleccionar un proveedor

Criar campanha

  • Selecionar um provedor Gupshup.

  • Colocar nombre de la app en el campo puerto.

NGINX debe ser modificado para que responda los eventos cuando se agrega la URL en Gupshup.

Para ello se debe agregar el siguiente párrafo en el archivo
  • 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;}

Interactive button list


Lista de Buttons Interativos

Tipo Buttons:

  • body: texto

  • buttonsButtons: 1 a 3

    • ID - title - descriptiondescrição

  • footerFooter: texto

Note

Todo lo qué se muestra en negrita es obligatorio.

Ejemplo

Tudo o que está em negrito é obrigatório

Exemplo:

Button:

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

1-Opción Opção 1

2-Opción Opção 2

3-Opción Opção 3

Interactive list

Lista Interativa

Ejemplo sin titulo para opcionesExemplo sem título de opções:

List:

button: Boton Texto da lista de listabotões

body: Algo de Algum texto

header: el headercabeçalho

title: Titulo de Título da lista

1-Opción Opção 1 - descripcion descrição 1

2-Opción Opção 2 - descripcion descrição 2

3-Opción Opção 3 - descripcion descrição 3

4-Opción Opção 4 - descripcion descrição 4

footer: el footerEjemplo con titulo para opcionesrodapé

Exemplo com título para opções:

List:

button: Boton Texto da lista de listabotões

body: Algo de Algum texto

header: el headercabeçalho

title: Titulo de Título da lista

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

1-Opción Opção 1 - descripcion descrição 1

2-Opción Opção 2 - descripcion descrição 2

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

3-Opción Opção 3 - descripcion descrição 3

4-Opción Opção 4 - descripcion descrição 4

footer: el footerrodapé


Para poder enviar hsm HSM's, debe ser por medio de un é preciso usar uma ID. Este ID se obtiene realizando una petición 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>

El app name y api key son los mismos parámetros que se utilizan al configurar un proveedor de Gupshup en O nome do aplicativo e a chave api são os mesmos parâmetros usados ao configurar um provedor Gupshup no uContact.

Templates

Las plantillas de mensajes pueden ser una herramienta valiosa para iniciar conversaciones con los usuarios. Las plantillas de texto se pueden acceder en la ventana de configuración del proveedor y utilizar en el buzón junto con respuestas predefinidas. En este proceso, es esencial reemplazar los marcadores de posición con los valores específicos requeridos como variables.

Image Removed

Sincronizar: Al hacer clic en este botón, se obtendrán todas las plantillas aprobadas de tipo texto asociadas a la cuenta. Una vez que la sincronización se realice con éxito, los miembros de la campaña podrán utilizar estas plantillas como respuestas prearmadas.

Eliminar: Este botón se utiliza para eliminar permanentemente todas las plantillas de la base de datos del proveedor en 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.

Image Added

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;variablevariável;variablevariável;variablevariável

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

hsm;id_template;tipo;mediaUrl;variablevariável;variablevariável;variablevariável

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

Contact

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