Como integrar a Optimove à Pushfy: guia de ativação em 15 minutos

11 min de leitura

Quem opera CRM em iGaming conhece a divisão de trabalho: a Optimove decide quem recebe, quando recebe e com qual mensagem; a Pushfy entrega e devolve o que aconteceu. O problema é quando essas duas metades não conversam direito. A campanha sai, mas o status volta errado, o opt-out fica preso de um lado só e ninguém consegue dizer quanto de depósito veio de qual disparo.

Este guia mostra o passo a passo completo para conectar sua conta Optimove à Pushfy. São cerca de 15 minutos de trabalho, quase todo ele copiando e colando três credenciais. Depois disso, o resto funciona sozinho: status de entrega por mensagem, respostas em tempo real, opt-out sincronizado nos dois sentidos e, opcionalmente, receita atribuída por campanha.

O que a integração entrega

Antes do passo a passo, vale saber o que fica de pé quando a conexão termina. Cinco blocos, e só os dois primeiros exigem configuração:

• Envio de campanhas: tudo que você cria na Optimove (campanhas agendadas e disparos triggered em tempo real) passa a sair pela Pushfy, por SMS.
• Canal RCS (opcional): os mesmos disparos saindo com marca verificada, sem o limite de 160 caracteres e, no formato Single, com card de imagem e botão.
• Status de entrega: automático. A Pushfy devolve um relatório por mensagem, então as métricas das suas campanhas na Optimove ficam corretas.
• Respostas e opt-out: automático. Resposta do jogador volta para a Optimove em tempo real, incluindo o “parar” que marca o descadastro.
• Conversions (opcional): cada depósito aprovado atribuído à última mensagem que alcançou o jogador, com receita, taxa de conversão e ROAS.

Antes de começar: três pré-requisitos

• Conta Pushfy ativa, com saldo de SMS e acesso de usuário master (administrador).
• Conta Optimove com a opção API Vendor habilitada para SMS. Se ela não aparecer no seu painel, peça a habilitação ao seu CSM da Optimove. Aproveite o mesmo chamado e solicite também a Server Key, que é usada na sincronização de opt-out, mais adiante. Pedir as duas coisas juntas economiza um dia de espera.
• Para usar RCS: RCS aprovado na sua conta Pushfy, com o agente da marca já provisionado.

Etapa 1 · Copie as credenciais na Optimove

No painel da Optimove, vá em Settings → SMS Configuration e selecione a opção API Vendor. Três dados aparecem na tela:

• Base URL
• API Token
• Secret Key

Atenção com a Secret Key. A Optimove só exibe esse valor antes de a conexão ser concluída. Copie os três de uma vez e guarde em lugar seguro. Se a Secret Key se perder, não há como consultá-la depois: será preciso regenerá-la na Optimove e refazer a conexão do zero.

Etapa 2 · Conecte no painel da Pushfy

No painel Pushfy, abra Integrações → aba Optimove e:

• Cole a Base URL, o API Token e a Secret Key.
• Preencha o Sender ID com o nome da sua marca e clique em Salvar.
• Clique em Conectar para fazer o handshake. O status deve mudar para Conectado.

Se a resposta for “já registrado”, também é sucesso, e significa apenas que a Optimove já reconhecia esse vendor. Pode seguir para o teste.

Sobre o Sender ID no Brasil

Vale um esclarecimento que evita confusão na primeira campanha: no Brasil, o remetente exibido no celular é definido pela rota da operadora (short code), e não pelo texto que você digitou. Isso é comportamento padrão do SMS brasileiro, não uma limitação da integração. O Sender ID que você informa aqui é o identificador nominal da conta dentro da Optimove.

Etapa 3 · Teste de ponta a ponta

Não confie no status “Conectado” como prova final. Dispare uma campanha de SMS de teste para o seu próprio número e confira os três pontos:

• No painel Pushfy, o quadro Atividade da aba Optimove mostra o lote recebido e processado em até 1 minuto.
• A mensagem chega ao aparelho e aparece nos Relatórios da Pushfy como um envio normal.
• Na Optimove, o status Delivered aparece na campanha assim que a operadora confirma a entrega.

Passou nos três, a integração está de pé. Campanhas agendadas e disparos em tempo real funcionam do mesmo jeito, sem nenhuma configuração extra. E todas as regras da sua conta Pushfy continuam valendo automaticamente: saldo, lista de bloqueados e limite de caracteres.

Etapa 4 · Canal RCS (opcional)

Se a sua conta já tem RCS aprovado, os mesmos disparos da Optimove podem sair pelo canal rico, com remetente verificado e sem o teto de 160 caracteres. Se você ainda está decidindo onde o RCS compensa, vale ler antes quais formatos de RCS usar em cada tipo de mensagem.

Na aba Optimove, mude o Canal de envio de SMS para RCS Basic ou RCS Single e clique em Salvar. A troca vale para todos os disparos e pode ser desfeita a qualquer momento, sem novo handshake.

Formato do template no RCS Single

O RCS Single monta um card com imagem e botão. Como a Optimove não tem campos separados para isso, a Pushfy interpreta o texto do template 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:

Promoção de Hoje https://site.com/banner.jpg Confira nossas ofertas válidas só hoje https://site.com/ofertas Ver ofertas

Três regras para não errar o card:

• Sempre dois links: primeiro a imagem (.jpg ou .png), depois o destino do botão.
• Com um link só, a mensagem vai sem imagem e esse link vira o destino do botão.
• As tags de personalização da Optimove funcionam normalmente dentro do texto.

O que esperar do RCS dentro da Optimove

Dentro da Optimove o canal continua rotulado como “SMS”, porque a plataforma não tem um canal RCS próprio, mas os status de entrega chegam corretos do mesmo jeito. Aparelhos sem RCS têm a mensagem rejeitada e reportada como Failed; se a sua conta tiver o fallback RCS → SMS ativo, a Pushfy reenvia por SMS automaticamente. A tarifação segue a tabela do canal efetivamente usado.

Status de entrega: como cada evento aparece na Optimove

Aqui não há nada a configurar. Conforme as operadoras confirmam, a Pushfy devolve um relatório por mensagem. Esta é a tradução exata entre o que aconteceu na rede e o que sua equipe lê no relatório da Optimove:

Respostas e opt-out

Quando um cliente responde a uma mensagem enviada pela Optimove, a resposta é repassada a ela em tempo real, incluindo “stop” e “parar”, que ela usa para marcar o opt-out do lado dela. O mesmo descadastro é registrado na Pushfy, permanentemente e para todos os canais.

Uma observação que evita mal-entendido: respostas de campanhas criadas fora da Optimove não são enviadas a ela. Só volta para lá o que saiu de lá.

Opcional: sincronização de opt-out em lote (duas vias)

O “parar” em tempo real já cobre o dia a dia. A sincronização em lote existe para manter as listas de supressão dos dois lados alinhadas, inclusive os descadastros que aconteceram por outros caminhos, como o preference center da Optimove.

Para ligar, tenha em mãos a Server Key da sua conta Optimove (aquela que você pediu ao CSM lá no começo). Na aba Optimove, ligue o toggle Sincronizar opt-out, cole a Server Key, selecione a região do seu tenant (US ou EU) e clique em Salvar. A partir daí:

• Pushfy → Optimove: descadastros da sua lista de bloqueados sobem para a lista de unsubscribes da Optimove, que para de segmentar esses clientes. Sobem apenas opt-outs de números que receberam mensagens pela Optimove.
• Optimove → Pushfy: opt-outs registrados na Optimove entram na sua lista de bloqueados e valem para todos os canais.
• A sincronização nunca remove ninguém. Re-subscrições na Optimove não reativam envios na Pushfy: o descadastro aqui é permanente, por decisão de compliance.
• Na primeira ativação, os opt-outs já existentes são enviados em uma carga inicial automática.

Conversions: receita por campanha (opcional)

Esta é a etapa que muda a conversa com a diretoria. Com o módulo Conversions ativo, cada depósito aprovado é atribuído à última mensagem que alcançou o jogador, e o painel passa a mostrar receita, taxa de conversão e ROAS por campanha, em vez de só taxa de entrega. É o mesmo raciocínio que sustenta a discussão de LTV do jogador e régua de comunicação: sem atribuição, a régua é ajustada no escuro.

O módulo é solicitado à Pushfy e não tem custo de setup. Com ele ativo, abra Conversions → Configurar webhook e copie sua URL exclusiva (https://portal.pushfy.com/conversions/<seu-token>) junto com o modelo de JSON.

Duas formas de enviar os depósitos

E se o evento chegar sem telefone? A atribuição funciona do mesmo jeito: a Pushfy identifica o jogador pelo customerID da Optimove, o mesmo das campanhas que já enviamos.

Checklist de ativação

Imprima, cole no card da sprint ou mande para o time. A ordem importa, porque cada item depende do anterior:

• API Vendor habilitado na Optimove (e Server Key solicitada ao CSM no mesmo chamado)
• Base URL, API Token e Secret Key copiados da Optimove
• Credenciais salvas na aba Optimove do painel Pushfy e handshake em Conectado
• Campanha de teste disparada e recebida no celular, com Delivered na Optimove
• (Opcional) Canal RCS selecionado e template Single no formato correto
• (Opcional) Sincronização de opt-out ligada, com Server Key e região
• (Opcional) Conversions: URL copiada e depósitos sendo enviados pela forma A ou B

Se algo não funcionar

Depois da ativação

Com a conexão de pé, a decisão que sobra é de estratégia, não de configuração: qual mensagem sai por SMS, qual justifica o RCS e qual momento do ciclo do jogador pede cada uma. Esse desenho está detalhado na matriz de canal por momento e em como combinar SMS e RCS para aumentar o LTV.

Se a sua operação também usa outro CRM em paralelo, o caminho é parecido por lá. Veja o guia de integração com a Smartico, onde a Pushfy é provedor nativo.

A documentação completa e sempre atualizada fica em portal.pushfy.com/docs → Integrações → Optimove, disponível em português, inglês e espanhol.

O time Pushfy acompanha a ativação de cada nova conta Optimove de perto. Se preferir fazer a conexão junto com um especialista, fale com o seu contato comercial ou abra um chamado pelo painel.