Saltar al contenido principal

Cómo administrar una lista de distribución para enviar notificaciones en WhatsApp

  • Actualización

Índice:

  1. Registro de todos Tus contactos
  2. Registro de todos tus contactos que ya han interactuado con tu bot
  3. Registro de todos tus contactos en una plataforma externa
  4. Crear una lista de distribución
  5. Crear lista de distribución a través de Builder
  6. Crear lista de distribución a través de API
  7. Incluir todos los números en la lista de distribución en el formato correcto

  8. Uso del Plugin para crear y administrar listas de distribución

 

Registro de todos Tus contactos

En primer lugar, dado que tus usuarios pueden provenir de diferentes plataformas y momentos, vamos a dividir en módulos este contenido para facilitar su comprensión. Sobre todo, cabe mencionar que todo el contenido de registro de contactos en WhatsApp está relacionado al número de contacto de los usuarios.

Registro de todos tus contactos que ya han interactuado con tu bot

Suponte que tienes un BLiP Chatbot y algunos usuarios que ya han interactuado con tu bot no están en tu lista de distribución. Para identificar a estos usuarios, debes utilizar el endpoint Get contacts with paging. Cuando se trata del canal de WhatsApp, el filtro utilizado en la consulta a continuación, devuelve todos los usuarios que se comunicaron con tu bot utilizando el canal de WhatsApp.

 

POST https://{{contractid}}.http.msging.net/commands HTTP/1.1
Content-Type: application/json
Authorization: Key YOUR_TOKEN


{  

  "id": "a456-42665544000-0123e4567-e89b-12d3",

  "method": "get",

  "uri": "/contacts?$filter=(substringof('WhatsApp'%2Csource))"

 

Para cada contacto devuelto en la consulta, habrá una clave identity, que representa el identificador del usuario en WhatsApp.

"items": [

            {

                "name": "John Doe 1",

                "identity": "553199999999@wa.gw.msging.net",

                "extras": {},

                "source": "WhatsApp"

            },

            {

                "name": "John Doe 2",

                "identity": "553188888888@wa.gw.msging.net",

                "phoneNumber": "+553188888888",

                "extras": {},

                "source": "WhatsApp"

            }

        

]

Registro de todos tus contactos en una plataforma externa

En posesión de los números de contacto, es necesario tener acceso al identificador del usuario en WhatsApp. Recuerda realizar esta operación solo una vez por cada cliente.

La búsqueda del identificador se actúa a través de una solicitud HTTP, teniendo en cuenta el número de teléfono celular del cliente en formato internacional "+DDI DDD NÚMERO_DE_TELÉFONO". PUNTO DE

 

ATENCIÓN: No olvide agregar el signo "+" antes de enviarlo. Para obtener más detalles sobre la verificación del usuario, la comprobación del contacto y la validez del número consultado, acceda aquí.

Aquí tienes un ejemplo de un número considerando el identificador del país como 55 (Brasil) y el DDD como 31 (Minas Gerais).

+5531999998888

POST https://{ORGANIZATION_ID}.http.msging.net/commands HTTP/1.1

Content-Type: application/json

Authorization: Key {YOUR_TOKEN}




{

"id": "{{$guid}}",

"to": "postmaster@wa.gw.msging.net",

"method": "get",

"uri": "lime://wa.gw.msging.net/accounts/+5531999998888"

}

Observa que uno de los encabezados de esta solicitud requiere un token de autorización de bot (YOUR_TOKEN). Para saber dónde encontrar el token de tu bot, haz clic aquí.

A continuación, se muestra un ejemplo de una respuesta a esta solicitud. Ten en cuenta que la propiedad del recurso tiene un objeto JSON que contiene la propiedad AlternativeAccount, este es el valor que identifica al cliente en el canal de WhatsApp.

 

5215599998888@wa.gw.msging.net

- identificador del cliente que tiene el número de móvil +52 1 55 99998888

{

    "type": "application/vnd.lime.account+json",

    "resource": {

        "fullName": "John Doe",

        "alternativeAccount": "5531999998888@wa.gw.msging.net",

        "identity": "5531999998888@wa.gw.msging.net",

        "phoneNumber": "+5531999998888",

        "source": "WhatsApp"

    },

    "method": "get",

    "status": "success",

    "id": "a456-42665544000-0123e4567-e89b-12d3",

    "from": "postmaster@wa.gw.msging.net",

    "to": "bot@msging.net",

    "metadata": {

        "#command.uri": "lime://wa.gw.msging.net/accounts/+5531999998888"

    }

}


Observación: Esta operación debe realizarse solo una vez para cada cliente.

Crear una lista de distribución

Actualmente, hay dos formas de crear una lista de distribución, directamente en Builder o utilizando la API. A continuación te mostramos cada uno de estos formularios con sus respectivas especificidades.

Crear lista de distribución a través de Builder

Para realizar la acción de crear una lista de distribución en Builder, haz clic en cualquier bloque y selecciona la pestaña Acciones. En la funcionalidad de Agregar Acción de Entrada, seleccione la opción Lista de Distribución. Con la finalización de todos los procesos anteriores, ingresa el nombre deseado en el campo Nombre de la Lista y haz clic en el botón Agregar Nueva Lista para concluir el proceso.

Crear lista de distribución a través de API

Para actuar la acción de crear una lista de distribución a través de API, usaremos el endpoint la documentación, debes reemplazar {your_distributionList} con el nombre deseado para tu lista.

 

POST https://{{contractid}}.http.msging.net/commands HTTP/1.1
Content-Type: application/json
Authorization: Key {YOUR_TOKEN}

{  

  "id": "1",

  "to": "postmaster@broadcast.msging.net",

  "method": "set",

  "type": "application/vnd.iris.distribution-list+json",

  "uri": "/lists",

  "resource": {  

    "identity": "{your_distributionList}@broadcast.msging.net"

  }

}

Incluir todos los números en la lista de distribución en el formato correcto

Finalizando todos los pasos anteriores, utilizaremos la API para incluir todos los contactos registrados en la lista creada. Para esto usaremos el endpoint add a member to list, para cada usuario a incluir debemos ejecutar la solicitud a continuación, recuerda reemplazar {your_distributionList} por el nombre de tu lista creada que se puede obtener en los pasos anteriores o en el endpoint get all list.

 

POST https://{{contractid}}.http.msging.net/commands HTTP/1.1
Content-Type: application/json
Authorization: Key {YOUR_TOKEN}

{  

  "id": "3",

  "to": "postmaster@broadcast.msging.net",

  "method": "set",

  "uri": "/lists/{your_distributionList}@broadcast.msging.net/recipients",

  "type": "application/vnd.lime.identity",

  "resource": "5531999998888@wa.gw.msging.net"

}
  • México (código 52): para adicionar perfis de usuários do México, é preciso adicionar o número “1” entre o código de país e o código de área para todos los números originados do país;
  • México (código 52): para adicionar perfis de usuários do México, é preciso adicionar o número “1” entre o código de país e o código de área para todos los números originados do país;
  • México (código 52): para adicionar perfis de usuários do México, é preciso adicionar o número “1” entre o código de país e o código de área para todos los números originados do país;
Uso del Plugin para crear y administrar listas de distribución

 

El Plugin Blip es una forma independiente de conectar recursos no oficiales para mejorar la funcionalidad del portal.

 

¿Cuáles son las características de este plugin/herramienta?

  • Ver todas las listas de distribución para su bot
  • Agregar una nueva lista de distribución
  • Eliminar listas de distribución
  • Ver todos los miembros de una lista de distribución
  • Eliminar miembros de una lista de distribución
  • Ver todos los contactos del bot
  • Agregar un contacto como miembro de una lista de distribución
  • Agregar un contacto como miembro de una lista de distribución desde un archivo [Nuevo]
  • Filtrar contactos de bots
  • Ver toda la información de un contacto

¿Cómo usar?

 

Requisito previo:

Active, la extensión de la lista de difusión a través de la tienda de Plugins.


mceclip0.png

Instrucciones

 

Para crear listas de distribución:

  1. Vaya a la pestaña “Administrar listas”
  2. Haga clic en el campo de entrada “New List” e ingrese el nombre deseado para la lista
  3. Haga clic en el botón “Add”

mceclip2.png

Para eliminar listas de distribución:

  1. Vaya a la pestaña “Manage Lists”
  2. Seleccione una o más listas en la tabla "List"
  3. Haga clic en el botón “Remove”

mceclip3.png

Para ver todos los miembros de una lista de distribución:

  1. Vaya a la pestaña “Manage Members”
  2. Seleccione una lista de distribución en la selección "List"

 

Para eliminar miembros de una lista de distribución:

  1. Vaya a la pestaña “Manage Members”
  2. Seleccione una lista de distribución en la selección "List"
  3. Seleccione uno o más miembros de la tabla “Members”
  4. Haga clic en el botón “Remove”

mceclip4.png

Para agregar un contacto como miembro de una lista de distribución:

  1. Vaya a la pestaña “Manage Contacts”
  2. Seleccione una lista de distribución en la selección "List"
  3. Seleccione uno o más contactos en la tabla “Contacts”
  4. Haga clic en el botón "Agregar “Add”

mceclip5.png

Para agregar un contacto como miembro de una lista de distribución:

  1. Vaya a la pestaña “Manage Contacts”
  2. Seleccione una lista de distribución en la selección "List"
  3. Elija el archivo .txt con el formato correcto
  4. Haga clic en el botón “Import”

mceclip6.png

Para obtener más información, acceda a la discusión sobre el tema en nuestra comunidad o los videos en nuestro canal. 😃

Artículos relacionados