Saltar para a documentação
API

Contar quem uma difusão alcançaria

Os números de que partiria um envio para estas audiências, sem enviar nem escrever nada: quantas pessoas alcançaria, quantas são ignoradas por terem cancelado a subscrição e quantas por o endereço estar suprimido. Um contacto em várias das audiências conta uma vez.

POSTapi.openemail.uk/broadcasts/preview

Executa a chamada real contra o seu espaço de trabalho, com a sua própria chave.

POST /broadcasts/preview

Os números de que partiria um envio para estas audiências, sem enviar nem escrever nada: quantas pessoas alcançaria, quantas são ignoradas por terem cancelado a subscrição e quantas por o endereço estar suprimido. Um contacto em várias das audiências conta uma vez.

Exemplo

Precisa só de audiences:read, por isso uma chave que não pode enviar pode ainda assim mostrar o número a alguém. audienceIds tem de 1 a 10 ids e mais nada é aceite no corpo.

curl
curl -X POST "$OE/broadcasts/preview" -H "$AUTH" -H 'content-type: application/json' -d '{  "audienceIds": ["aud_4c1b8e2a7d9f05c36b4e8a71", "aud_7e3d9a1c5b2f84e06d9a3c51"]}'
Resposta
{  "object": "broadcast_preview",  "audienceIds": ["aud_4c1b8e2a7d9f05c36b4e8a71", "aud_7e3d9a1c5b2f84e06d9a3c51"],  "recipients": 412,  "unsubscribed": 9,  "suppressed": 3}

unsubscribed conta os contactos que cancelaram a subscrição de todas estas audiências em que estão. Um contacto ainda com subscrição numa delas é contado em recipients.

suppressed conta os contactos com subscrição cujo endereço está na lista de supressão após uma devolução ou uma queixa, ou porque alguém o adicionou.

O número é tirado no momento da chamada. Um id que não indica nenhuma audiência dá 404 audience_not_found.