Pular para o conteúdo principal

Editar Contacto

atenção

Antes de utilizar as operações de manipulação de contactos de Audiência é necessário primeiro criar uma Audiência para a sua Organização, via plataforma Arpoone. Esta opção está disponível no menu: Audiência > Criar Audiência

A edição de um contacto contacto da audiência de uma organização pode ser feita através de dois endpoints:

  • identificação de contacto (recipient) por campo recipientId no URL do pedido
  • identificação de contacto (recipient) por conjunto de campos-chave audienceKeyFields no corpo do pedido

O corpo do pedido deve conter um objecto recipient onde os campos tags e subscriptions são opcionais e os seus campos do array fields estão em conformidade com o schema de audiência.

A edição de campos segue a seguinte estratégia:

  • No caso do campo fields, campos de audiência já existentes no recipient serão atualizados, ao passo que campos não existentes serão criados (desde que compatíveis com o schema de audiência). O campo name de cada objecto em fields identifica o campo da audiência a ser actualizado;
  • Os valores de tags serão introduzido no campo tags do recipient, ou adicionados a um array de tags já existente;
  • Os valores de subscriptions serão introduzidos no campo subscriptions do recipient, sobrepondo-se a subscrições anteriores.

Não é possível atualizar os valores de campos chave da audiência – tal situação resulta num erro com HTTP Status Code 400 – Bad Request

Aceder à API Reference