Como integrar a Smartico à Pushfy: guia completo de SMS, RCS e Conversions

12 min de leitura

A Pushfy é provedor nativo dentro da Smartico. Isso muda a natureza do trabalho: você não vai construir um gateway customizado nem pedir homologação. A Pushfy já está na lista de provedores do Back Office, ao lado dos outros. A ativação é escolher o nome, colar um token e copiar uma URL.

São cerca de 5 minutos para o gateway de SMS ficar de pé. Este guia cobre isso e o que vem depois: como criar as mensagens e disparar de fato, como os status de entrega e o opt-out voltam para a Smartico, como ligar o canal RCS e como fechar o ciclo medindo depósito por campanha no módulo Conversions.

O que a integração entrega

• Envio de SMS: campanhas do Journey Builder e automation rules em tempo real saem pela Pushfy.
• Status de entrega: automático, desde que a URL de callback seja cadastrada. É o passo mais esquecido da ativação inteira, e o único que faz a Smartico mostrar Delivered e Failed.
• Opt-out: automático. “PARAR”, “SAIR” e “CANCELAR” viram descadastro permanente na blacklist da conta.
• Canal RCS (opcional): marca verificada, sem o teto de 160 caracteres e, no formato Single, card com imagem e botão.
• Conversions (opcional): cada depósito aprovado atribuído à última mensagem que alcançou o jogador, com receita e ROAS por campanha.

Antes de começar

• Conta Pushfy ativa, com saldo de SMS e o token de API em mãos.
• Acesso ao Back Office da Smartico com permissão de Label, que é onde ficam os gateways.
• Para RCS: RCS aprovado na conta Pushfy, com o agente da marca provisionado.
• Para Conversions: módulo Conversions ativo na conta Pushfy (solicite ao seu contato, não há custo de setup).

Etapa 1 · Cadastrar o gateway de SMS

No Back Office da Smartico, vá em Label → Gateways → Instant Messages.

Se o seu painel ainda mostra o caminho antigo, a mesma tela aparece como Label → SMS Gateway. É o mesmo lugar: a Smartico renomeou a seção quando unificou SMS, WhatsApp, Viber e IVR sob “Instant Messages”.

A partir daí:

• Clique em Create para adicionar um novo gateway.
• Selecione Pushfy na lista de provedores e clique em Next.
• No campo URL, informe: https://portal.pushfy.com/api
• No campo Authorization, cole o token de API da sua conta Pushfy.

O passo que não pode ser pulado: a URL de callback

Ainda nessa tela de configuração, a Smartico exibe uma URL de callback. Copie e envie ao time Pushfy. É por ela que devolvemos o status de cada mensagem.

Sem esse passo, a integração parece funcionar: as mensagens saem, chegam no aparelho do jogador e aparecem nos Relatórios da Pushfy. Mas a Smartico fica cega: sem Delivered, sem Failed, e todo relatório de campanha lá dentro nasce vazio na coluna que mais importa. É o erro número um da ativação, e ele demora dias para ser percebido, porque nada dá erro.

Clique em Finalizar para concluir o cadastro.

Teste de ponta a ponta

Monte uma jornada simples apontando para o seu próprio número e dispare. Dois pontos de conferência:

• A mensagem chega ao aparelho e aparece em Relatórios, no painel Pushfy, como um envio normal.
• Depois que o callback estiver cadastrado, o status Delivered aparece na Smartico assim que a operadora confirma.

Etapa 2 · Como fazer os envios

Gateway cadastrado é encanamento pronto, mas ainda não é campanha. O disparo em si tem duas peças na Smartico: o asset (a mensagem) e o que dispara (campanha ou automation rule).

Criar a mensagem

Vá em Marketing → Assets → Instant Messages e crie um asset do tipo SMS. Os campos principais:

• Asset Name: é por esse nome que você seleciona a mensagem dentro da campanha. Vale adotar uma convenção desde o primeiro asset; em três meses são dezenas deles.
• Asset Status: Active, Draft ou Archived.
• Message Content: o texto da mensagem.

Atenção ao tamanho e à acentuação. O SMS padrão (codificação GSM) comporta 160 caracteres por segmento. Emoji e determinados caracteres especiais jogam a mensagem inteira para Unicode, e aí o segmento cai para 70 caracteres. Mensagens acima do limite são divididas em segmentos concatenados, e cada segmento é cobrado. Um emoji decorativo no fim do texto pode dobrar o custo de uma campanha de milhões de disparos sem que ninguém perceba na revisão.

Para personalizar, use as content variations: você configura as propriedades relevantes (idioma, nível, moeda, país) e cria versões do texto para cada recorte de base.

Uma armadilha que vale conhecer: se o asset estiver em Draft ou Archived mas já tiver sido usado em uma campanha, a comunicação continua saindo. O que não sai são as variações individuais marcadas como Draft ou Archived. Arquivar um asset não é o mesmo que desligar a campanha.

Escolher o que dispara

A Smartico separa dois mecanismos, e a escolha errada aqui custa retrabalho:

Nos dois casos existe a divisão entre real-time (dispara no evento: depósito, login, mudança de nível, KYC concluído) e scheduled (roda em intervalo definido, com Execution Speed controlando quantos jogadores recebem por minuto). Vale usar o Control Group desde a primeira campanha: sem grupo de controle, não existe forma honesta de provar que o SMS causou o depósito.

Se a dúvida for qual mensagem merece qual canal e em que momento do ciclo do jogador, o desenho está na matriz de canal por momento.

Etapa 3 · Status de entrega e opt-out

Nada a configurar aqui, desde que a URL de callback da Etapa 1 tenha sido enviada. Com ela cadastrada, a Pushfy devolve o status de cada mensagem conforme as operadoras confirmam, e a Smartico usa esse retorno nos relatórios de campanha e no Smartico DWH.

O opt-out também é automático. Quando o jogador responde PARAR, SAIR ou CANCELAR, o número entra na blacklist da conta Pushfy de forma permanente. Duas consequências que valem estar claras para o time de CRM:

• O bloqueio vale para todos os canais da conta, não só para a campanha que gerou a resposta.
• O descadastro é permanente: não há reativação automática por parte da Smartico. É uma decisão de compliance, e ela protege a operação. A régua de retenção depende de base saudável, não de base grande, como discutimos em LTV do jogador e régua de comunicação.

Etapa 4 · Canal RCS (opcional)

Com RCS aprovado na conta, os mesmos disparos da Smartico podem sair pelo canal rico. Existem dois caminhos, e a diferença entre eles é basicamente prazo.

Modo A · Nativo

Peça ao time Smartico a ativação do RCS Pushfy informando o seu token. É o caminho mais limpo: o canal passa a existir dentro da plataforma, sem gateway adicional para manter.

Modo B · Imediato

Se você não quer esperar, cadastre integrações extras apontando para os endpoints de RCS da Pushfy:

• https://portal.pushfy.com/apircsbasic para RCS Basic
• https://portal.pushfy.com/apircs para RCS Single

A autenticação é a mesma: o token da conta no campo Authorization.

Formato do template no RCS Single

O RCS Single monta um card com imagem e botão. Como o campo de texto da Smartico é único, a Pushfy interpreta a mensagem pela ordem das partes, separadas por espaço:

TÍTULO  [link da imagem]  CORPO DA MENSAGEM  [link de destino]  TEXTO DO BOTÃO

Na prática:

Bônus liberado https://site.com/banner.jpg Seu bônus de recarga está disponível até meia-noite https://site.com/deposito Resgatar agora

Duas regras que definem o card:

• Sempre dois links: primeiro a imagem (.jpg ou .png), depois o destino do botão.
• Com um link só, a mensagem sai sem imagem e esse link vira o destino do botão.

Se você ainda está decidindo onde o RCS compensa e onde o SMS resolve, vale ler antes quais formatos de RCS usar em cada tipo de mensagem e como combinar os dois canais para aumentar o LTV.

Etapa 5 · Conversions: depósito atribuído à campanha

Esta é a etapa que muda a conversa com a diretoria. Em vez de taxa de entrega, o painel passa a mostrar receita, taxa de conversão e ROAS por campanha. Cada depósito aprovado atribuído à última mensagem que alcançou aquele jogador.

1. Copie sua URL exclusiva na Pushfy

No painel Pushfy, abra Conversions → Configurar webhook e copie a URL https://portal.pushfy.com/conversions/<seu-token> junto com o modelo de JSON.

2. Crie a regra na Smartico

No Back Office: CRM Automation → Automation Rules → + New Rule.

• Tipo da regra: Real-time.
• Gatilho: Deposit approved (depósito aprovado).
• Atividade: WebHook, método POST, content type application/json.
• URL: a sua URL exclusiva do passo anterior. Corpo: o modelo de JSON fornecido pela Pushfy.

3. Teste

Faça um depósito de teste. Ele aparece no painel Conversions em segundos. Não há janela de processamento em lote.

Dois comportamentos que já vêm resolvidos e costumam gerar dúvida:

• Estornos são descontados automaticamente. Depósito cancelado não fica inflando a receita da campanha.
• Jogador com telefone protegido pelo Data Guard é identificado pelo ID. Mesmo sem o número no evento, a atribuição funciona normalmente, porque o mascaramento de dado pessoal da Smartico não quebra a medição.

Checklist de ativação

• Token de API Pushfy em mãos e acesso de Label no Back Office da Smartico
• Gateway criado em Label → Gateways → Instant Messages, provedor Pushfy
• URL e Authorization preenchidos
• URL de callback copiada e enviada ao time Pushfy (sem isso não há status)
• Jornada de teste para o próprio número, mensagem recebida e visível em Relatórios
• Delivered aparecendo na Smartico depois do callback ativo
• Asset de SMS criado em Marketing → Assets → Instant Messages, dentro do limite de caracteres
• (Opcional) RCS ativado no Modo A ou Modo B, com o template Single no formato correto
• (Opcional) Conversions: regra real-time em Deposit approved com WebHook apontando para a URL exclusiva

Se algo não funcionar

Depois da ativação

Com gateway, status, opt-out e Conversions no lugar, a Smartico deixa de ser só o lugar onde a campanha é montada e passa a ser o lugar onde ela é julgada: quanto entrou de depósito por régua, por segmento e por criativo. Daí em diante a discussão é de estratégia, não de configuração.

Se a sua operação também usa outro CRM em paralelo, o caminho é o mesmo por lá. Veja o guia de integração com a Optimove.

A documentação completa e sempre atualizada fica em portal.pushfy.com/docs → Integrações → Smartico. O time Pushfy acompanha a ativação de cada nova conta Smartico de perto: se preferir fazer a configuração junto com um especialista, fale com o seu contato comercial ou abra um chamado pelo painel.