# 360Dialog WhatsApp
{% hint style="info" %}
La API de 360Dialog WhatsApp se ejecuta como un servicio administrado. Puede [**solicitar una cuenta aquí**](https://api.whatsapp.com/send?phone=573336025020\&text=Quiero%20crear%20una%20cuenta%20de%20360Dialog) con un beneficio exclusivo para clientes de 1980TIC o [**Contáctenos**](https://api.whatsapp.com/send?phone=573336025020\&text=Hola!%20Necesito%20soporte) si tiene preguntas.
{% endhint %}
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
{% hint style="warning" %}
Este canal tiene una ventana de mensajería limitada de 24 horas debido a las regulaciones de WhatsApp. \
¡Descubra más [aquí](https://docs.1980tic.us/canales-de-mensajeria/whatsapp) !
{% endhint %}
## 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**](https://hub.360dialog.com/auth/login) \
Inicie sesión con sus credenciales de usuario y obtenga su clave de la API. Puede consultar esta [guía](https://docs.360dialog.com/360-client-hub/api-key) 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
{% hint style="success" %}
Una vez que hayas completado la configuración, cualquier mensaje enviado a tu número de 360Dialog WhatsApp será recibido en tu Espacio
{% endhint %}
## Configuración del canal
{% hint style="info" %}
El canal 360Dialog WhatsApp puede ser configurado con un único:\
\- Nombre del canal\
\- Mensaje de saludo
{% endhint %}
**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.
{% hint style="warning" %}
**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.
{% endhint %}
**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](https://hub.360dialog.com/auth/login) 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.
|
{% hint style="warning" %}
¡Las Plantillas de Mensajes requerirán un Cuerpo y los otros bloques de construcción son opcionales!
{% endhint %}
**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
{% hint style="info" %}
Si no tiene una plantilla de mensaje aprobada o desea enviar una nueva plantilla de mensaje, consulte la siguiente guía.
{% endhint %}
**Paso 1: Descargar Postman** \
Descargue el cliente API usando este [enlace](https://www.postman.com/downloads/) 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
| Name | Type | Description |
| ------------ | ------ | --------------------------------- |
| D360-API-KEY | string | The API key provided by 360Dialog |
{% tabs %}
{% tab title="200 " %}
```
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
```
{% endtab %}
{% endtabs %}
**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"
```
{% hint style="info" %}
Las instrucciones detalladas para presentar las plantillas de mensajes para su aprobación están disponibles en la [Documentación de 360Dialog.](https://docs.360dialog.com/api/whatsapp-api/message-templates-api#create-a-template)
{% endhint %}
### Comprobación del estado de la presentación
**Paso 1: Descargar Postman** \
Descargue el cliente API usando este [enlace](https://www.postman.com/downloads/) 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
| Name | Type | Description |
| ------ | ------- | ---------------- |
| limit | integer | default: 1000 |
| offset | integer | default: 0 |
| sort | string | id, name, status |
#### Headers
| Name | Type | Description |
| ------------ | ------ | --------------------------------- |
| D360-API-KEY | string | The API Key provided by 360Dialog |
{% tabs %}
{% tab title="200 " %}
```
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
```
{% endtab %}
{% endtabs %}
**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í](https://www.twilio.com/docs/whatsapp/tutorial/send-whatsapp-notification-messages-templates#whatsapp-notification-categories) 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.
{% hint style="warning" %}
**Enlaces importantes** \
[Directrices Mensaje de WhatsApp](https://developers.facebook.com/docs/whatsapp/message-templates/guidelines)
{% endhint %}
## Solución de problemas
{% hint style="info" %}
¿Tienes problemas con el canal? ¡Contáctanos [aquí](https://api.whatsapp.com/send?phone=573336025020\&text=Hola!%20Necesito%20soporte)!
{% endhint %}