Objeto de destinatarios

El objeto destinatarios te permite solicitar o escribir información en nuestros endpoints.

En este objeto se requiere external_user_id, user_alias, o email. Las solicitudes deben especificar sólo una.

El objeto destinatario te permite combinar el objeto alias de usuario, el objeto propiedades de desencadenar y el objeto propiedades de entrada Canvas.

Cuerpo del objeto

1
2
3
4
5
6
7
8
[{
  "user_alias": (optional, User Alias Object) User alias of user to receive message,
  "external_user_id": (optional, string) see External user ID,
  "email": (optional, string) email address of user to receive message,
  "prioritization": (optional, array) see Prioritization; required when using email,
  "trigger_properties": (optional, object) personalization key-value pairs for this user when sending a campaign or message; see Trigger Properties,
  "canvas_entry_properties": (optional, object) personalization key-value pairs for this user when triggering a Canvas; see Canvas Entry Properties
}]

Cuando send_to_existing_only es true, Braze sólo enviará el mensaje a los usuarios existentes. Sin embargo, esta bandera no puede utilizarse con alias de usuario. Cuando send_to_existing_only es false, debe incluirse un atributo. Braze creará un usuario con la dirección id y los atributos antes de enviar el mensaje.

• Alias de usuario
• ID usuario externo
• Priorización

Desduplicación del objeto destinatario

Al realizar una llamada a la API con el objeto destinatario, si existe un destinatario duplicado que se dirija a la misma dirección (es decir, correo electrónico, push), se dedupirá al usuario, es decir, se eliminarán los usuarios idénticos, dejando uno solo.

Por ejemplo, si se utiliza el mismo external_user_id, solo se recibirá un mensaje. Considera la posibilidad de realizar varias llamadas a la API si necesitas una solución para este comportamiento.

1
2
3
4
{"campaign_id":"#####","recipients":[
{"external_user_id":"userid1","trigger_properties":{"name":"Beth Test 1"}},
{"external_user_id":"userid1","trigger_properties":{"name":"Beth Test 2"}} 
]}