Alterações na API de Listar Distribuições

Atualizações do modelo de retorno nos endpoints de “Listar todas distribuições de uma pesquisa” e “Listar uma distribuição” na API da Track CXM

Visando uma melhor estruturação da resposta dos endpoints de “Listar todas distribuições de uma pesquisa” e “Listar uma distribuição” e na prevenção e correção de bugs, a partir do dia 27/03/2024 o modelo de retorno será alterado.

 

Solicitamos que tenha atenção aos pontos de alteração abaixo para que continue recebendo os dados corretamente. Os principais pontos de alteração foram:

 

Campos adicionados:

  • Adição do campo failed;

  • Adição do campo "survey_hash".

 

Campos retirados:

  • Retirada dos campos: "bounce", "dropped", "spam_report" e "deferred".

  • Retirada dos campos: "duplicated", "unsubscribed" e "quarantine", esses poderão ser consultados nos campos:

    • "error_duplicated_customer_counter",

    • "error_duplicated_channel_counter",

    • "error_unsubscribed_channel_counter" e

    • "error_quarantine_counter".

  • Retirada dos campos a seguir devido a duplicidade desnecessária:

    • "error_no_customer_counter"

    • "error_duplicated_customer_counter"

    • "error_duplicated_channel_counter"

    • "error_unsubscribed_channel_counter"

    • "error_unknown_channel_counter"

    • "error_blockrule_counter"

    • "error_blocked_counter"

    • "error_quarantine_counter"

    • "error_no_channel_counter"

    • "error_identifier_format_counter"

    • "error_channel_attribute_format_counter"

    • "error_parse_counter"

 

Com as alterações listadas, o retorno dos endpoints passam a seguir o seguinte formato:

{
"data": {
"distribution": [
{
"uuid": "...",//string
"distribution_name": "...",//string
"distribution_chanel": "...",//int
"survey_uuid": "...",//string
"survey_name": "...",//string
"schedule_at": "...",//time
"validity_at": "...",//time
"reminder_at": "...",//time
"counter": "...",//int
"distributed_at": "...",//time
"added": "...",//int
"valid": "...",//int
"processed": "...",//int
"delivered": "...",//int
"opened": "...",//int
"clicked": "...",//int
"failed": "...",//int
"answered": "...",//int
"done": "...",//int
"partial": "...",//int
"invalid": "...",//int
"not_delivered": "...",//int
"invalid_errors": {
"error_no_customer_counter": "...",//int
"error_duplicated_customer_counter": "...",//int
"error_duplicated_channel_counter": "...",//int
"error_unknown_channel_counter": "...",//int
"error_no_channel_counter": "...",//int
"error_identifier_format_counter": "...",//int
"error_channel_attribute_format_counter":
"...",//int
"error_parse_counter": "...",//int
},
"not_delivered_errors": {
"error_unsubscribed_channel_counter": "...",//int
"error_blockrule_counter": "...",//int
"error_blocked_counter": "...",//int
"error_quarantine_counter": "...",//int
},
"total_processed_counter": "...",//int
"error_response_counter": "...",//int
"sender_type": "...",//int
"distribution_hash": "...",//string
"survey_hash": "...",//string
"organization_hash": "...",//string
"created_at": "..."//time
}
]
},
"success": "success",
"message": ""
}"

 

Se você utiliza nossa API na CXM de listar distribuições (todas de uma pesquisa ou distribuições), realize a alteração imediatamente.

 

Toda nossa documentação sobre API e integrações pode ser conferida aqui!

 

Em caso de dúvida, entre em contato com o nosso time de Atendimento ao cliente pelo chat ali no canto inferior direito da tela ou nos envie um e-mail com sua dúvida para suporte@track.co, ou ainda pode nos ligar no telefone: (11) 4858-9924.

 

 

Será um prazer te ajudar!