Objeto de agendamento

Os parâmetros para os endpoints de criação de campanha e canva espelham os do endpoint de envio e adicionam o parâmetro schedule, que permite especificar quando você deseja que seus usuários-alvo recebam sua mensagem. Se você incluir apenas o parâmetro time no objeto schedule, as mensagens Braze serão enviadas a todos os seus usuários naquele momento.

Se você definir in_local_time como true, você receberá uma resposta de erro se o parâmetro de tempo tiver passado em todos os fusos horários. Se você definir at_optimal_time como verdadeiro, seus usuários receberão a mensagem na data designada no horário ideal (independentemente do horário que você fornecer). Ao usar o envio no horário local ou no horário ideal, não forneça designadores de fuso horário no valor do parâmetro de tempo (por exemplo, use "2015-02-20T13:14:47" em vez de "2015-02-20T13:14:47-05:00").

A resposta fornece a você um schedule_id que você deve salvar caso precise cancelar ou atualizar a mensagem que agendou mais tarde:

Corpo do objeto

Insira este objeto conforme necessário para agendar suas mensagens.

1
2
3
4
5
"schedule": {
  "time": (required, datetime as ISO 8601 string) time to send the message in UTC,
  "in_local_time": (optional, bool),
  "at_optimal_time": (optional, bool),
}

Resposta de ID de agendamento

Você recebe um schedule_id pela mensagem agendada que criou.

1
2
3
{
  "schedule_id" : (required, string) identifier for the scheduled message you created
}

Se você usar a API para chamadas de servidor para servidor, pode ser necessário colocar na lista de permissões o URL apropriado da API se ela estiver atrás de um firewall.

As respostas do endpoint de agendamento de mensagens incluem o dispatch_id da mensagem para referência de volta ao envio da mensagem. O dispatch_id é o ID do despacho da mensagem (ID único para cada ‘transmissão’ enviada pela Braze).