TTL - Time to Live
Envio com TTL (Time to Live - Tempo de vida do HSM antes de ser entregue)
Descrição da Feature:
A partir da v2.21.3 (https://developers.facebook.com/docs/whatsapp/changelog#app), é permitido informar o TTL (em dias) para expiração da entrega das mensagens (ou seja, Tempo de Vida).
- As empresas podem usar isso para garantir que as mensagens não sejam entregues em datas posteriores ao definido.
- Atualmente, o TTL só pode ser definido em mensagens do tipo template;
- Se a mensagem não for entregue para o cliente antes do período definido como limite, ou seja expiração, está a mensagem não será entregue.
- Uma notificação de status (CallBack) será enviada pelo WA.
- A notificação de status poderá ser enviada para nossos clientes desde que configurado.
IMPORTANTE: a definição de TTL tem como limitadores:
- Somente mensagens do tipo HSM;
- no mínimo 1 dia (24 horas) do momento do envio da mensagem;
- no máximo 30 dias;
- default 7 dias. (Atualmente, este valor poderá ser alterado);
- o TTL tem validade a partir do envio da mensagem, ou seja, em caso de agendamentos, o TTL será atribuído somando-se o valor à data de disparo da mensagem.
- Em caso de um envio receber um valor inferior a 1 dia, ou superior a 30 dias, nossa plataforma , no momento de entregar a mensagem irá atribuir os valores dentro do permitido.
- Este comportamento foi implementado para evitar que tenhamos problemas na entrega das mensagens, pois caso exista uma tentativa de entrega de mensagem que não respeite aos valores mínimo e máximo para o TTL, esta mensagem será recusada pelo container.
Exemplo de envio:
2019-01-18;11:0;11:15;HSM;chatclub_welcome;pt_BR;DETERMINISTIC;name|empresa;2
telefone;name;empresa
5519998873499;mozart;Sinch
5519981794226;diego;Sinch
A informação que vai representar o TTL fica no fim da primeira linha, após os parâmetros do Template.
Essa informação vai ser um número INTEIRO que é representado em número de dias. Ou seja, teremos um TTL de 2 dias. Significa que após 2 dias da data e hora de envio da mensagem, caso o destinatário não receba a mensagem, essa mensagem NÃO SERÁ MAIS ENTREGUE.
{
"destinations": [{
"correlationId": "MyCorrelationId",
"destination": "5519900001111"
}],
"message": {
"ttl": 1,
"hsm": {
"namespace": "namespace",
"elementName": "elementName",
"parameters":[
"MyParam1",
"MyParam2"
]
}
}
}
Last modified 5mo ago