Versions Compared

Key

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

...

Configurar un webhook

Per creare Para crear un nuovo nuevo webhook, vai alla pagina Configurazioni > Gestione console > Avanzate > Webhooks e clicca sul pulsante Aggiungi nuovo ve a la página Configuración> Gestión consola > Avanzados > Webhooks y haz click en Añadir nuevo webhook.

I webhook, come abbiamo accennato nell'introduzione ai webhooks, sono facilmente personalizzabili e quindi, quando ne crei uno nuovo, puoi configurarne diversi aspetti: 

...

  • Subscribe: un destinatario si è iscritto alla Lista
  • Unsubscribe: un destinatario si è disiscritto alla Lista
  • Changeprofile: i dati di un destinatario nel suo profilo sono stati modificati incluso, per esempio, il Gruppo di appartenenza
  • Delete: un destinatario è stato rimosso dalla Lista

...

Los webhook, como hemos comentado en la introducción a los webhooks, son fácilmente personalizables y por tanto, al crear uno nuevo, se pueden configurar varios aspectos: 

  • Nombre: introduce un nombre comprensible sobre el uso de dicho webhook (se utilizará sólo internamente). 
  • URL: se trata del Callback URL, el URL de la página que recibe la "llamada" cuando se envía un mensaje automático desde el webhook.  
  • Tipo: en este momento hay disponibles 4 eventos que desencadenan la ejecución de un webhook: 
    • Suscripción: un destinatario se ha inscrito en la Lista. 
    • Baja: un destinatario se ha dado de baja en la Lista. 
    • Cambio de perfil: los datos del perfil de un destinatario han sido modificados, incluídos datos como por ejemplo, el Grupo al que pertenece. 
    • Eliminación: un destinatario ha sido eliminado de la Lista. 
  • Fuente: un evento puede tener lugar en 3 ambientes (fuentes) diferentes: 
    • API: el evento se ha dado gracias a una llamada API (por ejemplo, cuando un destinatario se registra mediante un módulo que realiza una llamada API a la consola para modificar la base de datos). 
    • Consola: el evento se ha llevado a cabo por alguien directamente desde la consola (por ejemplo, cuando un destinatario ha sido añadido manualmente).  
    • Recipient (Destinatario): l'el evento ha registrato un'azione fatta dal destinatario (esempio: il destinatario si è disiscritto) 
  • Metodo: il metodo utilizzato per eseguire tecnicamente la chiamata che può essere in POST o in GET 
  • Attivo: se il webhook è attivo oppure no
  • Criptato: se il webhook è criptato oppure no (in caso lo fosse dovrai specificare la chiave) 
    • MailUp utilizza RC4 encryption e la chiave fornita per criptare
    • i dati vengono convertiti in codice  Base64 
    • La pagina di ricezione della chiamata - conoscendo al chiave - può facilmente estrarre i dati criptati 
  • Parametri: i parametri inviati nella chiamata, vedi sotto per i dettagli. 

Image Removed

 

Parametri

I parametri che possono essere inclusi nelle chiamate sono:
  • [EventDate]: la data in cui si è verificato l'evento in formato ISO 8601  (esempio.
    • registrado una acción hecha por el destinatario (por ejemplo, cuando el destinatario se ha dado de baja). 
  • Método: el método utilizado para realizar técnicamente la llamada, que puede ser en POST o en GET. 
  • Activación: si el webhook está activo o no. 
  • Codificación: si el webhook está encriptado o no (si lo está, es necesario especificar la contraseña)  
    • MailUp utiliza RC4 encryption y la contraseña entregada para encriptar. 
    • Los datos se convierten en código  Base64 
    • La página de recepción de la llamada - conociendo la contraseña - puede fácilmente extraer los datos encriptados. 
  • Parámetros: los parámetros enviados en la llamada, ve abajo para ver los detalles. 

Menu creacion webhookImage Added

Parámetros

Los parámetros que pueden incluírse en las llamadas son:
  • [EventDate]: la fecha en que se ha verificado el evento en formato ISO 8601  (por ejemplo: 2012-09-12T11:18:37.664+02)
  • [IdConsole]: l'ID dell'accountel ID de la cuenta
  • [IdList]: l'el ID della de la Lista
  • [IdNL]: l'el ID del messaggiomensaje
  • [EventType]: il el tipo di de evento
  • [EventSource]: la sorgente dell'fuente del evento
  • [Reason]: la ragione per cui il destinatario si è disiscritto, si applica solamente alla disiscrizione e include il codice che definisce i vari tipi di Bouncerazón por la cual el destinatario se ha dado de baja. Se aplica sólo a las bajas e incluye el código que define los varios tipos de Bounce.
  • [Email]: l'indirizzo la dirección email del destinatario
  • [Prefix]:  il prefisso internazionale del numero telefonico  el prefijo internacional del número de teléfono del destinatario
  • [Number]: il numero telefonico el número de teléfono del destinatario
  • [Groups]: una lista, separata da virgole, dei Gruppi a cui appartiene il destinatario all'interno di separada por comillas, de los Grupos a los que pertenece el destinatario de una Lista [IdList]
  • [Channel]: canale di comunicazione segnalato da dei codicicanal de comunicación señalado por códigos: 0 (Email), 1 (Sms), 2 (Fax), 5 (Social), -1 (Unknown quindi , o sea, un evento non collegato no asociado a un canalecanal)Tutti i Campi anagrafici nel .
  • Todos los Campos anagráficos en el formato [Nome] ... [indirizzo]

...

Límites de los webhooks

In questo momento non vengono eseguite delle chiamate webhook nel caso di:

...

En este momento, no se realizarán llamadas webhook en el caso de:  

  • importes masivos 
  • uso de webservice
Info

I Los webhook sono applicabili son apicables a una Lista specifica e non è al momento possibile creare un webhook da applicare a tutte le Liste. In pochi passi, al momento della creazione di una nuova lista, è possibile copiare un webhook da altre liste esistenti.

Argomenti correlati

...

específica y de momento no es posible crear un webhook que se aplique a todas las Listas. Con pocos pasos, en el momento de la creación de una Lista, se puede copiar un webhook de otras listas ya existentes.

Argumentos relacionados