Não há nenhuma aplicação para instalar no Customer.io. Constrói ambas as direções com ações padrão do Customer.io, por isso decide exatamente que pedidos são executados e que atributos mudam.
Como funciona a integração
O Flowella nunca chama a API do Customer.io. Na direção opcional de entrada, o Flowella apenas publica eventos no URL de webhook que lhe indicar, e a sua automação decide o que fazer com eles.
Antes de começar
- Uma organização Flowella com um número WhatsApp ligado. Consulte Sequência de configuração.
- Um modelo WhatsApp aprovado no Flowella. Consulte Modelos.
- A função Owner ou Admin no Flowella, para criar uma chave de API e, para a sincronização de entrada, um webhook. Consulte Equipa e funções.
- Um espaço de trabalho Customer.io onde possa criar campanhas ou automações com ações de webhook.
- O número WhatsApp de cada pessoa guardado no respetivo perfil Customer.io em formato internacional, como
+447700900123. Consulte Formato do número de telefone. - O consentimento de cada pessoa para receber mensagens WhatsApp suas. A Meta exige opt-in antes de enviar mensagens a alguém. Consulte as orientações de opt-in da Meta.
Enviar um modelo WhatsApp a partir do Customer.io
1
Criar uma chave de API do Flowella
No Flowella, aceda a Settings e depois API keys, e crie uma chave de produção com um nome como
Customer.io production. Copie-a de imediato: o Flowella só a mostra uma vez. Consulte Chaves de API.2
Encontrar os IDs do modelo e do canal
Chame
GET /v1/templates?status=APPROVED com a sua chave. Anote o id e o wabaId do modelo e o whatsappChannelId do número a partir do qual quer enviar. Consulte Multicanal se tiver vários números.3
Adicionar uma ação de webhook à campanha
No fluxo de trabalho da sua campanha Customer.io, adicione uma ação Send and receive data no ponto em que a mensagem WhatsApp deve sair. Consulte o guia do Customer.io sobre ações de webhook.
4
Configurar o pedido
Defina o método como
POST e o URL como https://api.flowella.io/v1/templates/send. Adicione estes cabeçalhos:5
Escrever o corpo do pedido
Cole este corpo e substitua os IDs pelos seus. Altere
customer.phone para o atributo que contém o número WhatsApp da pessoa.bodyParameters preenche as variáveis do corpo do modelo por ordem: o primeiro valor vai para {{1}}, o segundo para {{2}}, e assim por diante. Deixe uma lista vazia, [], se o modelo não tiver variáveis no corpo.6
Testar a ação
Escolha uma pessoa de teste com o seu próprio número WhatsApp e selecione Test response no Customer.io. Adicione um cabeçalho
Idempotency-Key com um valor que ainda não tenha usado, como test-2026-11-11-01, e altere-o em cada teste. Consulte Envios repetidos e idempotência.Uma resposta 202 com "status": "accepted" significa que o Flowella colocou o envio em fila. Não confirma a entrega: verifique o resultado no separador Statistics do modelo no Flowella.7
Remover o cabeçalho de teste e iniciar a campanha
Elimine o cabeçalho
Idempotency-Key que usou nos testes, ou substitua-o por um valor diferente para cada pessoa. Depois, inicie a campanha.Opções do modelo que pode definir por pessoa
O corpo do pedido aceita estes campos para cada destinatário. A introdução à API e o documento OpenAPI descrevem o pedido completo.
Para um modelo com cabeçalho de imagem, vídeo ou documento, pode definir uma ligação pública para o ficheiro em
headerMedia.url, no nível superior do corpo.
Envios repetidos e idempotência
POST /v1/templates/send protege-o de enviar a mesma mensagem duas vezes, o que é importante porque o Customer.io repete uma ação de webhook quando não recebe uma resposta 2xx:
- Sem um cabeçalho
Idempotency-Key, o Flowella usa um hash do corpo do pedido como chave. Um corpo idêntico byte a byte no prazo de 7 dias devolve oidoriginal e não envia nada. Como o corpo de cada pessoa contém o seu próprio número, uma campanha normal envia uma vez para todos. - Com um cabeçalho
Idempotency-Key, qualquer pedido com a mesma chave no prazo de 7 dias devolve oidoriginal e não envia nada, mesmo que o corpo tenha mudado. - Além disso, o Flowella ignora um segundo envio do mesmo modelo para o mesmo número no prazo de 15 segundos.
Idempotency-Key de cada vez.
Enviar para um segmento grande
Cada pedido do Customer.io coloca um envio em fila, e o Flowella entrega-o em segundo plano, repetindo em caso de erros temporários do WhatsApp. Aplicam-se dois limites a campanhas grandes:- O limite de mensagens da Meta. A Meta limita o número de pessoas a quem pode enviar mensagens fora da janela de 24 horas num período móvel de 24 horas. Consulte Limites de mensagens.
- O limite de taxa da sua chave de API. Os pedidos acima do limite devolvem
429com um cabeçalhoRetry-After. Consulte Limites de taxa.
Sincronizar mensagens WhatsApp recebidas com o Customer.io (opcional)
Esta parte envia para o Customer.io cada mensagem WhatsApp que um contacto lhe envia, para que possa atualizar a pessoa ou iniciar outras campanhas a partir dela.1
Criar uma automação acionada por webhook no Customer.io
Crie uma campanha ou automação acionada por webhook e copie o URL de webhook que o Customer.io gera. Consulte o guia do Customer.io sobre campanhas de webhook.
2
Adicionar um webhook de saída no Flowella
No Flowella, aceda a Settings e depois Webhooks, e selecione Add webhook. Cole o URL do Customer.io em Endpoint URL, introduza um segredo de assinatura e assinale apenas
message.received em Events. Consulte Webhooks.3
Enviar dados de exemplo
Envie a si próprio um modelo WhatsApp a partir do Flowella e responda-lhe, para que o Customer.io receba um evento Send test event no Flowella envia um evento
message.received real a partir do qual pode construir o fluxo de trabalho. Cada evento tem este aspeto:webhook.test, que não tem contacto, por isso filtre-o no passo seguinte.4
Manter apenas as mensagens recebidas reais
Adicione um True/False Branch que só continua quando o
type do acionador é message.received.5
Procurar o contacto no Flowella
O evento contém IDs, não o número de telefone. Adicione uma ação Send and receive data com o método
GET, o URL https://api.flowella.io/v1/contacts/{{trigger.data.contactId}} e o mesmo cabeçalho Authorization de antes. A resposta inclui o id, phone, waId, name, email, externalId, isOptedOut, createdAt e updatedAt do contacto.Para guardar a própria mensagem, adicione outro pedido a GET /v1/messages/{{trigger.data.messageId}}. O campo body contém o texto da mensagem e pode estar vazio.6
Atualizar a pessoa
Adicione uma ação Create or Update Person. Escolha o identificador que o seu espaço de trabalho usa para pessoas e defina apenas os atributos de que precisa, como a hora da última resposta WhatsApp. Consulte o guia do Customer.io sobre Create or update person.
Segurança do webhook de entrada
O Flowella assina todos os pedidos com o cabeçalhoX-Flowella-Signature. Uma automação acionada por webhook no Customer.io não consegue verificar essa assinatura, por isso qualquer pessoa que tenha o URL de webhook do Customer.io pode publicar dados nele. Mantenha o URL privado e não use a sincronização de entrada para alterar atributos de consentimento ou de faturação. Consulte Verificar assinaturas se encaminhar primeiro os eventos através do seu próprio endpoint.
Opt-outs
Quando um contacto enviaSTOP ou outra palavra-chave de opt-out, o Flowella regista o opt-out nesse número WhatsApp e bloqueia todos os envios seguintes para esse contacto a partir desse número, incluindo os envios a partir do Customer.io. Consulte Opt-outs.
Para copiar os opt-outs para o Customer.io, não dependa do evento optout.created: de momento, não é disparado no primeiro opt-out de um contacto num número. Em vez disso, liste os opt-outs com GET /v1/opt-outs, que aceita os filtros createdAfter e phone.
Resolução de problemas
Relacionado
Introdução à API
Autenticação, idempotência, limites de taxa e erros.
Referência de webhooks
Tipos de eventos, corpos de pedido e assinaturas.
Variáveis de modelos
Variáveis, exemplos e valores de recurso.
Envio em massa
Em alternativa, envie um modelo para uma lista a partir da aplicação Flowella.

