O WhatsApp nas suas jornadas do Customer.io.

Adicione uma ação de webhook a uma jornada do Customer.io e esta enviará um modelo do WhatsApp aprovado pela Meta através da API da Flowella, preenchido com os dados de cada pessoa. As respostas chegam à sua caixa de entrada da Flowella.

Comece gratuitamente Referência da API

Funciona hojeAtravés da API da Flowella e dos webhooks
Em breveA integração nativa com o Customer.io

A Flo, a mascote da Flowella, a lançar um aviãozinho de papel verde com uma das mãos levantadas, enquanto segura um telemóvel na outra

Enviar uma mensagem pelo WhatsApp a partir de uma etapa da viagem.

Eis um percurso do Customer.io, ilustrado ao estilo da Flowella. Escolha um modelo ou altere o nome próprio da Ada para ver exatamente o que a etapa do webhook envia para a API da Flowella; depois, execute-o e veja o modelo a chegar ao telemóvel dela.

Funciona hoje através da API

Renovação da adesãoPercurso no Customer.io

Dados de exemplo

A Ada chega à etapa do webhook+447700900123

GatilhoÉ incluído no segmento «Renovação prevista para daqui a 7 dias»
EsperaAté às 10h00 no fuso horário deles
WebhookEnvia um modelo do WhatsApp através da API da Flowella

Modelo
Enviado como «templateId», o ID do modelo no Flowella.

Olá, {{1}}, a tua adesão ao Acme Club renova-se a {{2}}. Renova num instante, aqui mesmo no WhatsApp.Renove agora

Olá, {{1}}, vemo-nos na {{2}} no sábado. Toca aqui em baixo para veres o teu bilhete ou alterares a tua reserva.Ver a minha reserva

Obrigado, {{1}}. A tua doação de {{2}} já está a fazer a diferença. Toca aqui para veres o teu recibo.Obter o meu recibo

Nome próprio {{1}}

Do perfil da Ada no Customer.io. Tenta outro nome.

Adicione um nome próprio. Uma variável de modelo não pode ficar em branco.

Data de renovaçãoEventoValor do presente{{2}}
31 de outubroFeira de Outono25 librasDo perfil dela
EntãoA jornada continua no Customer.io

Pedido de webhookO que esta etapa envia para o Flowella

Dados de exemplo

POSThttps://api.flowella.io/v1/templates/send

Cabeçalhos

Authorization: Bearer flo_(oculta)A sua chave API, ocultada
Content-Type: application/json

Corpo

{
  "templateId": "clsamplerenewal0000000001",
  "whatsappChannelId": "clsamplechannel0000000001",
  "recipients": [
    {
      "phone": "+447700900123",
      "bodyParameters": [
        "Ada",
        "31 de outubro"
      ]
    }
  ]
}

A resposta da Flowella

Ainda não foi enviadoEnvio202 Accepted

Execute este passo para ver a resposta da Flowella.

Envio para a API da Flowella

{
  "id": "v1ts-0123456789abcdef",
  "status": "accepted"
}

Aceite e colocado na fila para a sua organização. Flowella envia-o em segundo plano.

A mesma solicitação, o mesmo trabalho: não foi enviado nada de novo.

Acme ClubConta empresarial

Dados de exemplo

Hoje

Escolha um modelo ou altere o nome próprio da Ada e, em seguida, execute o passo. O pedido foi alterado. Execute o passo para o enviar. Adicione primeiro o nome próprio da Ada: uma variável de modelo não pode estar vazia. O Customer.io envia o pedido à API da Flowella. A Flowella respondeu «202 Aceite» e colocou o envio na fila. O modelo está no telemóvel da Ada. O mesmo pedido novamente, pelo que o Flowella trata-o como uma repetição: o mesmo trabalho, sem uma segunda mensagem.

Configure-o em três passos.

Precisas de uma conta Flowella com o WhatsApp ligado, um modelo aprovado pela Meta e um percurso no Customer.io. Depois:

Passo 1: Criar uma chave API

Na Flowella, aceda a Definições → Chaves API e crie uma chave para o Customer.io. Apenas os Proprietários e os Administradores podem fazê-lo, e a Flowella mostra a chave apenas uma vez.

Chaves APIDados de exemplo

Etiqueta
Produção do Customer.io

Chave
flo_••••••••

Última utilização
Ainda não

Ativo
Como funcionam as chaves API
Passo 2: Adicionar uma ação de webhook

Na sua jornada, adicione uma ação de webhook que envie um pedido POST para api.flowella.io/v1/templates/send, com a chave no cabeçalho «Authorization».

Ação do webhookDados de exemplo

Método
POST

URL
https://api.flowella.io/v1/templates/send

Título
Authorization: Bearer flo_••••

Pronto
O endpoint na íntegra
Passo 3: Preencha o corpo do texto

O corpo do JSON indica o nome do modelo e do seu canal do WhatsApp, seguido do número de telefone da pessoa e das variáveis do seu perfil. A Flowella responde com «202 Accepted» e envia a resposta.

A resposta da FlowellaDados de exemplo

Estado
202 Accepted

Corpo
"status": "accepted"

Entrega
Em segundo plano

Em fila
Referência da API

O que funciona hoje e o que está para vir.

Tudo o que foi referido acima funciona através da API da Flowella e dos webhooks, já disponíveis. A integração nativa com o Customer.io estará disponível em breve.

Em breve

A integração nativa com o Customer.io

Publicaremos aqui como funciona assim que estiver pronto. Até lá, uma ação de webhook e a API da Flowella dão conta do recado.

É bom saber

Um pedido por pessoaCada pessoa que chega a esta etapa recebe o seu próprio pedido, com o seu próprio número de telefone e variáveis.
202 significa «em fila»Flowella aceita o envio, coloca-o na fila para a sua organização e entrega-o em segundo plano.
Listas completas de uma só vezUm pedido pode incluir até 50 000 destinatários, e a opção «throttlePerHour» regula a entrega por si.
As respostas permanecem no FlowellaAs respostas chegam à sua caixa de entrada do Flowella. Não são reenviadas para o Customer.io.