360Dialog WhatsApp

Conexión de una cuenta API de WhatsApp 360Dialog para chatear con clientes a través de Whatsapp.

La API de 360Dialog WhatsApp se ejecuta como un servicio administrado. Puede solicitar una cuenta aquí con un beneficio exclusivo para clientes de 1980TIC o Contáctenos si tiene preguntas.

360Dialog es un proveedor de API que trabaja directamente con WhatsApp. Proporciona a las empresas números de teléfono de compra y cuentas API oficiales de WhatsApp.

Esta integración de la API de WhatsApp 360Dialog le permite responder a los mensajes de WhatsApp directamente desde la plataforma 1980TIC

Este canal tiene una ventana de mensajería limitada de 24 horas debido a las regulaciones de WhatsApp. ¡Descubra más aquí !

Conectando la API de WhatsApp 360Dialog

Paso 1: Navegar a la configuración de los canales Desde el módulo de configuración, navegar a la opción de menú, Canales

Paso 2: Añadir un canal Pulsa Añadir canal y elige WhatsApp. Selecciona 360Dialog en el segundo paso

Paso 3: Ingresar al 360Dialog Hub Inicie sesión con sus credenciales de usuario y obtenga su clave de la API. Puede consultar esta guía para saber cómo hacerlo.

Paso 4: Rellene la información requerida Añade el número de WhatsApp habilitado y la clave API de 360Dialog Hub

Paso 5: Completar la configuración en 1980TIC Presione DONE para completar la configuración

Una vez que hayas completado la configuración, cualquier mensaje enviado a tu número de 360Dialog WhatsApp será recibido en tu Espacio

Configuración del canal

El canal 360Dialog WhatsApp puede ser configurado con un único: - Nombre del canal - Mensaje de saludo

Paso 1: Navegar a la configuración de los canales Desde el módulo de configuración, navegar a la opción de menú, Canales

Paso 2: Localizar el canal WhatsApp de 360Dialog Una vez que hayas localizado el canal 360Dialog WhatsApp, pulsa Configurar

Paso 3: Hacer la configuración necesaria Puede configurar lo siguiente:

  • Nombre del canal - Nombre usado internamente para identificar la cuenta

  • Mensaje de saludo - Este mensaje es el primer mensaje que se envía al contacto cuando te envían un mensaje a través de 360Dialog WhatsApp.

Importante: En cuanto al resto de detalles, toma nota extra durante la actualización, ya que podría no recibir mensajes de tu cuenta WhatsApp de 360Dialog.

Paso 4: Actualizar la configuración Presione Hecho para actualizar la configuración del canal

Gestión de plantillas de mensajes de WhatsApp

Antes de enviar un mensaje de plantilla a un contacto en la plataforma 1980TIC, por favor asegúrese de hacer lo siguiente:

  • Enviar la plantilla del mensaje para su aprobación

  • Añadió la plantilla de mensajes aprobada al espacio

Envío de la plantilla de mensajes para su aprobación a través de 360Dialog Hub

Paso 1: Iniciar sesión en 360Dialog Hub Navega a 360Dialog Hub e ingresa con tu correo electrónico y contraseña.

Paso 2: Accede a las plantillas de mensajes Busque el número de WhatsApp al que desea agregar una plantilla de mensajes y haga clic en el botón Administrar plantillas.

Paso 3: Crear una plantilla de mensajes Haga clic en el botón azul Agregar Plantillas

Paso 4: Llena la información requerida

Campo

Descripción

Nombre

El nombre sólo puede contener caracteres alfanuméricos en minúscula y guiones bajos ( _ )

Categoría

La categoría a la que pertenece la plantilla de mensajes

Idioma

El idioma en el que está escrita la plantilla

Tipo

Estándar (sólo texto) o Plantilla de medios

Paso 5a: Creación de plantillas estándar Las Plantillas de Mensajes Estándar sólo tienen una sección de CUERPO. Para añadir una variable, inserte en la posición dada, donde # representa el índice de la variable, que debe comenzar en

Paso 5b: Creación de plantillas de medios Las plantillas de medios tienen un conjunto diferente de bloques de construcción como sigue :-

Bloque de construcción

Descripción

Encabezado

El encabezado es opcional y sirve como título o encabezado de su plantilla. Admite lo siguiente:

  • Texto

  • Imagen

  • Documentos

  • Video

Cuerpo

El Cuerpo debe contener el texto más importante de su plantilla. Sólo se admite el texto.

Pie de pagina

El pie de página sólo admite texto y puede utilizarse para proporcionar información menos relevante en su plantilla de mensaje

Botón

El botón añade interactividad a sus plantillas. Hay dos tipos principales.

  • Botón de respuesta rápida

    • Se utiliza para obtener respuestas rápidas de su cliente

    • Máximo 3 botones de respuesta rápida por plantilla

  • Botón de llamada a la acción

    • Se utiliza para enviar a su cliente a un sitio web o llamar a un número de teléfono

    • Un máximo de un URL y un número de teléfono por plantilla

¡Las Plantillas de Mensajes requerirán un Cuerpo y los otros bloques de construcción son opcionales!

Paso 4: Someter a aprobación Revise la información y envíela cuando esté listo

Presentación de la plantilla de mensajes para su aprobación

Si no tiene una plantilla de mensaje aprobada o desea enviar una nueva plantilla de mensaje, consulte la siguiente guía.

Paso 1: Descargar Postman Descargue el cliente API usando este enlace y complete la configuración. Puedes saltarte este paso si has descargado Postman.

Paso 2: Agregar una solicitud Presione el botón + como se resalta en la siguiente captura de pantalla y aparecerá un formulario de solicitud vacío.

Paso 3: Configurar la solicitud Cambie el tipo de solicitud a POST y añada la siguiente URL de solicitud

POST https://waba.messagepipe.io/v1/configs/templates

Headers

NameTypeDescription

D360-API-KEY

string

The API key provided by 360Dialog

object	{WABA Template}	
    name	string	optional
    namespace	string	optional
    category	string	optional
    components	array[object]	optional
        type	string	Allowed Values: BODY, HEADER, FOOTER, BUTTONS
        format	string	Allowed Values: TEXT, IMAGE, DOCUMENT, VIDEO
        text	string	optional
        example	string	optional
        buttons	object	optional
            type	string	Allowed Values: PHONE_NUMBER, URL, QUICK_REPLY
            text	string	required
            url	string	optional
            phone_number	string	optional
            example	string	optional
    language	string	optional
    rejected_reason	string	optional
    status	string	optional

Paso 4: Añadir encabezamientos a la solicitud Seleccione la pestaña Cabecera y añada los parámetros descritos anteriormente.

Paso 5: Añadir la siguiente carga útil Selecciona la pestaña Cuerpo y elige el formato crudo. Seleccione JSON como tipo de datos. Pegue el siguiente texto en el campo de texto.

{
    "name": "template_name",
    "category": "ACCOUNT_UPDATE",
    "language": "en",
    "components": [
		{
            "type": "BODY",
            "text": "template_text"
        }
    ]
}

Por favor, asegúrese de haber llenado los siguientes parámetros con la información pertinente

Parámetros

Descripción

nombre

El nombre utilizado para identificar su mensaje de plantilla

categoría

La categoría en que se clasifica esta plantilla de mensaje

lenguaje

El idioma que se describe en esta plantilla de mensaje.

texto

El contenido del texto del mensaje de plantilla

Paso 6: Enviar la solicitud Presente la solicitud y recibirá la siguiente respuesta si se presenta con éxito

{
    "category": "ACCOUNT_UPDATE",
    "components": [
        {
            "text": "template_text",
            "type": "BODY"
        }
    ],
    "language": "en",
    "name": "template_name",
    "namespace": "xxxxxxxx_xxxx_xxxx_xxxx_xxxxxxxxxxxx",
    "rejected_reason": null,
    "status": "submitted"

Las instrucciones detalladas para presentar las plantillas de mensajes para su aprobación están disponibles en la Documentación de 360Dialog.

Comprobación del estado de la presentación

Paso 1: Descargar Postman Descargue el cliente API usando este enlace y complete la configuración. Puedes saltarte este paso si has descargado Postman.

Paso 2: Agregar una solicitud Presione el botón + como se resalta en la siguiente captura de pantalla y aparecerá un formulario de solicitud vacío.

Paso 3: Configurar la solicitud Cambie el tipo de solicitud a GET y añada la siguiente URL de solicitud

GET https://waba.messagepipe.io/v1/configs/templates

Path Parameters

NameTypeDescription

limit

integer

default: 1000

offset

integer

default: 0

sort

string

id, name, status

Headers

NameTypeDescription

D360-API-KEY

string

The API Key provided by 360Dialog

object
count integer optional
filters object optional
limit integer optional
offset integer optional
sort array[string] optional
total integer optional
waba_templates array[object] {WABA Template} optional
    name string optional
    namespace string optional
    category string optional
    components array[object] optional
        type string ALLOWED VALUES: BODY, VALUE, FOOTER, BUTTONS required
        format string ALLOWED VALUES: TEXT, IMAGE, DOCUMENT, VIDEO optional
        text string optional
        example string optional
    buttons object optional
        type string ALLOWED VALUES: PHONE_NUMBER, URL, QUICK_REPLY required
        text string required
        url string optional
        phone_number string optional
        example string optional
    language string optional
    rejected_reason string optional
    status string optional

Paso 4: Añadir encabezamientos a la solicitud Seleccione la pestaña Cabecera y añada los parámetros descritos anteriormente

Paso 5: Enviar la solicitud Presente la solicitud y recibirá la siguiente respuesta si se presenta con éxito.

Todas las plantillas que haya presentado se enumerarán en la respuesta junto con el estado de la presentación. Si necesita volver a presentarla, por favor repita este paso.

{
    "count": 3,
    "filters": {
    },
    "limit": 1000,
    "offset": 0,
    "sort": [
        "id"
    ],
    "total": 3,
    "waba_templates": [
        {
            "category": "ACCOUNT_UPDATE",
            "components": [
                {
                    "text": "Thank you for your request. \nAs Facebook closes the conversation after 24hours we cannot reach out to you anymore besides this template. \nIf you like to get in contact with us again and revoke the conversation please just click on one of the buttons and we get back to you.",
                    "type": "BODY"
                }
            ],
            "language": "en",
            "name": "test_1",
            "namespace": "xxxxxxxx_xxxx_xxxx_xxxx_xxxxxxxxxxxx",
            "rejected_reason": "NONE",
            "status": "APPROVED"
        },
        {
            "category": "TICKET_UPDATE",
            "components": [
                {
                    "text": "Thank you for reaching out to us. We are looking into your request and get back to you.",
                    "type": "BODY"
                }
            ],
            "language": "en",
            "name": "test_2",
            "namespace": "xxxxxxxx_xxxx_xxxx_xxxx_xxxxxxxxxxxx",
            "rejected_reason": "NONE",
            "status": "APPROVED"
        },
        {
            "category": "TICKET_UPDATE",
            "components": [
                {
                    "text": "Hello {{1}}! This is a test message, setup with API version {{2}}",
                    "type": "BODY"
                }
            ],
            "language": "en",
            "name": "test_3",
            "namespace": "xxxxxxxx_xxxx_xxxx_xxxx_xxxxxxxxxxxx",
            "rejected_reason": "NONE",
            "status": "APPROVED"
        }
    ]
}

Añadiendo la plantilla de mensajes de WhatsApp aprobada al espacio

Una vez que su Plantilla de mensajes haya sido aprobada en 360Dialog, puede proceder a agregar la plantilla de mensajes en la plataforma 1980TIC.

Paso 1: Navegue a la configuración del canal Desde el módulo de configuración , navegue hasta la opción del menú, Canales

Paso 2: Ubique el canal 360Dialog WhatsApp Una vez que haya localizado el canal 360Dialog WhatsApp, presione Plantillas

Paso 3: Complete la información requerida

Campos

Tipo

Descripción

Nombre de la plantilla

Texto

Un nombre utilizado para identificar la plantilla.

Contenido de la plantilla

Texto

La plantilla de mensaje aprobada por WhatsApp y para enviar al contacto.

ID de plantilla

Texto

El identificador único proporcionado por la API de socios de WhatsApp

Categoría

Selección única

¿A qué categoría pertenece esta plantilla? Consulte aquí la lista de categorías.

Idioma

Selección única

En qué idioma está escrita esta plantilla

Paso 4: Guarde los cambios Revise la información y presione GUARDAR cuando esté listo.

Solución de problemas

¿Tienes problemas con el canal? ¡Contáctanos aquí!

Última actualización