Ações de Callback
Esta página mostra como as Ações de Callback no Fast Track CRM podem acionar fluxos de trabalho automatizados, comunicar com sistemas externos e desbloquear novas possibilidades para experiências personalizadas para jogadores.
As Callback Actions permitem que o FT CRM comunique diretamente com sistemas externos sempre que uma Activity é acionada. Quer precise de obter dados em tempo real da sua plataforma para o CRM, quer precise de enviar eventos de jogadores para uma API de terceiros, os Callbacks fazem-no automaticamente — nos bastidores, sem trabalho manual.
Existem dois tipos de Callback Action: GET (o FT CRM solicita dados ao seu sistema) e POST (o FT CRM envia dados para o seu sistema). Perceber qual o tipo mais adequado ao seu caso de utilização é a chave para desbloquear esta funcionalidade.
🛠️ Como funciona
Pense nisto como uma reação em cadeia:
GET: FT CRM é acionado → envia um pedido à sua API → o seu sistema devolve dados estruturados → o FT CRM usa esses dados para preencher um menu suspenso ou conduzir a lógica na Activity.
POST: FT CRM é acionado → envia dados do jogador ou da campanha para o endpoint da sua API → o seu sistema externo recebe-os e atua sobre eles (por exemplo, aplica uma etiqueta, credita um bónus, atualiza o registo de um jogador).
GET Callbacks — Obter dados para o FT CRM
Os GET callbacks permitem ao FT CRM obter dinamicamente listas ou valores da sua plataforma quando uma Activity está a ser configurada. Isto é útil quando pretende que os utilizadores do CRM possam selecionar a partir de opções em tempo real — como tipos de bónus, títulos de jogos, definições de idioma ou etiquetas de jogadores — que residem no seu sistema em vez de estarem codificados no FT CRM.
O que a sua API precisa de devolver
Para que os GET callbacks funcionem, o seu endpoint tem de devolver dados no seguinte formato normalizado:
json
Cada item da data é apresentado como uma opção selecionável na interface do FT CRM. O campo text é o que os utilizadores do CRM veem; o value é o que é enviado quando a Action é acionada.
Suporte para várias marcas
Se a sua plataforma servir várias marcas, a sua API pode ser configurada para aceitar um parâmetro brand ou origin para que o conjunto de dados correto seja devolvido por marca. Operadores de marca única podem usar um endpoint estático sem este parâmetro.
Aspetos a ter em conta
Os GET callbacks exigem que a sua equipa adapte a sua API existente para corresponder ao formato de resposta acima. Para a maioria dos parceiros isto é simples, mas vale a pena confirmar com a sua equipa técnica antes de construir fluxos de trabalho que dependam disso.
POST Callbacks — Enviar dados para sistemas externos
Os POST callbacks enviam dados do FT CRM para a sua plataforma sempre que uma Activity é acionada. Esta é a opção certa quando precisa de atualizações de eventos em tempo real, dados de jogadores ou informações de campanhas entregues à sua própria API.
POST nativos vs personalizados
POST callbacks nativos (por exemplo, Credit Bonus Funds, Credit Bonus Code) são integrações pré-configuradas. Não precisa de especificar um URL, método ou autenticação — isto é tratado automaticamente pelo FT CRM. Os callbacks nativos estão prontos a usar desde que a sua integração os suporte.
POST callbacks personalizados exigem que forneça o endpoint da sua API, os detalhes de autenticação e uma estrutura de payload JSON. Pode usar marcadores dinâmicos no corpo do payload para inserir dados do jogador ou valores de outros campos da ação no momento do acionamento. Por exemplo:
json
- {action_field:campaign_id} — obtém o valor de outro campo dentro da mesma Callback Action
- ["#UserId#"] — insere dinamicamente o ID do jogador a partir dos dados do segmento
Exemplo de POST Custom Callback - Usado para a Integração Unibo
Exemplo de POST Custom Callback - Usado para a Integração Unibo
Múltiplas Callback Actions
Se precisar de acionar mais do que um callback a partir de uma única Activity, pode criar actions adicionais e definir o Tipo de Notificação no formato triggercallback.action1, triggercallback.action2, e assim sucessivamente. Cada action pode ter o seu próprio URL, método e payload.
triggercallback.example
triggercallback.example
As Callback Actions também são suportadas em Recompensas! Para as utilizar, certifique-se de que:
- Siga o triggercallback.examplename formato
- Ative a definição "Recompensas Ativadas"
💡 Casos de Utilização e Inspiração
Cancelar um Bónus numa Solicitação de Levantamento
Se um jogador solicitar um levantamento enquanto tiver um bónus ativo, o FT CRM pode acionar automaticamente um Callback para a sua API para cancelar esse bónus — sem necessidade de intervenção manual.
Acompanhamento de Indicações de Amigos
Quando um jogador indicado faz o seu primeiro depósito, uma Callback Action notifica a sua plataforma com os dados da indicação, acionando automaticamente o bónus do referenciador.
Integração do Bot de Bónus
Quando um jogador abre o chat e solicita um bónus, o sistema verifica a elegibilidade e — se o jogador reunir os requisitos — aciona um Callback para creditar o bónus diretamente através da sua API.
Sincronização Interna do Programa de Fidelização
Envie dados de bónus e recompensas em tempo real do FT CRM para o seu sistema de fidelização interno, mantendo pontos, níveis e estados dos jogadores consistentes entre plataformas sem atualizações manuais.
RCS e Mensagens Avançadas
Os POST callbacks são usados em integrações de Rich Communication Services (RCS) para փոխանցir campos de texto e ativos multimédia do FT CRM para um fornecedor de mensagens.
🧱 Como configurar
As instruções completas de configuração técnica — incluindo campos obrigatórios, tipos de autenticação, estrutura do payload e requisitos do formato de resposta — estão cobertas na Documentação de Integração das Callback Actions.