Criar e atualizar usuários (síncrono)
Use esse endpoint para registrar eventos personalizados e compras e atualizar atributos do perfil de usuário de forma síncrona. Esse endpoint funciona de forma semelhante ao endpoint
/users/track, que atualiza perfis de usuário de forma assíncrona.

Este endpoint está atualmente em beta limitado. Embora não estejamos adicionando novos clientes ao beta neste momento, informe ao seu gerente de conta da Braze se você acha que esse recurso pode ser útil para a sua integração com a Braze.
Chamadas síncronas e assíncronas à API
Em uma chamada assíncrona, a API retorna o código de status 201, indicando que sua solicitação foi recebida, compreendida e aceita com sucesso. No entanto, isso não significa que sua solicitação tenha sido totalmente concluída.
Em uma chamada síncrona, a API retorna o código de status 201, indicando que sua solicitação foi recebida, compreendida, aceita e concluída com sucesso. A resposta da chamada mostra campos selecionados do perfil de usuário como resultado da operação.
Esse endpoint tem um limite de frequência menor do que o endpoint /users/track (consulte Limite de frequência). Cada solicitação /users/track/sync pode conter apenas um objeto de evento, um objeto de atributo ou um objeto de compra. Esse endpoint deve ser reservado para atualizações de perfil de usuário em que uma chamada síncrona é necessária. Para uma implementação saudável, recomendamos usar /users/track/sync e /users/track juntos.
Por exemplo, se você estiver enviando solicitações consecutivas para o mesmo usuário em um curto período de tempo, condições de corrida são possíveis com o endpoint assíncrono /users/track. Já com o endpoint /users/track/sync, você pode enviar essas solicitações em sequência, cada uma após receber uma resposta 2XX.
Perguntas frequentes
Devo usar o endpoint assíncrono ou síncrono?
Para a maioria das atualizações de perfil, o endpoint /users/track funciona melhor devido ao seu limite de frequência mais alto e à flexibilidade para agrupar solicitações em lote. No entanto, o endpoint /users/track/sync é útil se você estiver enfrentando condições de corrida devido a solicitações rápidas e consecutivas para o mesmo usuário.
O tempo de resposta é diferente do endpoint /users/track?
Com uma chamada síncrona, a API espera até que a Braze conclua a solicitação para retornar uma resposta. Por isso, solicitações síncronas levam, em média, mais tempo do que solicitações assíncronas para /users/track. Na maioria dos casos, você pode esperar uma resposta em segundos.
Posso enviar várias solicitações ao mesmo tempo?
Sim, desde que as solicitações sejam para usuários diferentes ou que cada solicitação atualize atributos, eventos ou compras diferentes para um mesmo usuário.
Se você estiver enviando várias solicitações para um mesmo usuário, para o mesmo atributo, evento ou compra, a Braze recomenda aguardar uma resposta bem-sucedida entre cada solicitação para evitar a ocorrência de condições de corrida.
Se ainda assim você observar inconsistências no estado do perfil ao chamar /users/track para o mesmo usuário em rápida sucessão, migre essas atualizações para /users/track/sync e envie uma solicitação por vez, aguardando cada resposta 2XX antes da próxima. Essa ordenação é a forma suportada de evitar condições de corrida de leitura após escrita em loops rápidos ou workers paralelos.
Por que o valor da resposta não corresponde ao da minha solicitação original?
Embora sua solicitação tenha sido concluída, é possível que o valor do atributo personalizado não tenha sido atualizado. Isso pode acontecer quando a atualização do atributo personalizado excede o número máximo de caracteres, excede os limites do array ou se o usuário não existe na Braze e você definiu _update_existing_only = true.
Nessas situações, considere a resposta como um sinal de que sua solicitação foi concluída, mas a atualização desejada não foi efetuada. Investigue os possíveis motivos listados em Por que o valor da resposta não corresponde ao da minha solicitação original?.
Você pode baixar o documento OpenAPI e usá-lo para validar esquemas. Para saber como, consulte Usar esquemas OpenAPI para validação de solicitações.