Desenvolva a partir do Flowella, de forma programática.
Quando as ferramentas sem código não oferecem uma determinada funcionalidade, a API REST da Flowella e os webhooks de saída permitem fazê-lo. Recorra à API para enviar mensagens pelo WhatsApp, gerir contactos e cancelamentos de subscrição, bem como obter dados analíticos. Subscreva os webhooks para reagir em tempo real a mensagens, entregas, cancelamentos de subscrição e alterações de modelos, sem necessidade de sondagens.
Liga-lhe e deixa que ele te ligue de volta.
Duas direções, um único motor. A sua aplicação chama a API REST para executar as tarefas: enviar um modelo, atualizar um contacto, obter dados analíticos. Na outra direção, o Flowella envia eventos de webhook assinados para o seu ponto de extremidade assim que algo acontece, para que possa reagir instantaneamente, em vez de ter de fazer poling. Juntos, permitem-lhe construir tudo o que a sua pilha de tecnologias necessita, com base no mesmo motor do WhatsApp e da HubSpot.
Enviar, gerir e gerar relatórios
Uma API REST v1 simples, com autenticação por chave de portador e comportamento previsível.
A API REST é a versão 1, disponível em https://app.flowella.io/api/v1. Cada pedido inclui uma chave de portador com âmbito da organização no cabeçalho «Authorization», criada em «Configurações», «Chaves API» por um Proprietário ou Administrador e apresentada apenas uma vez. Os pontos finais de lista utilizam paginação por cursor com um limite de um a cem, os erros são devolvidos num envelope consistente com um campo de código estável e as solicitações são limitadas por organização com um 429 quando se vai demasiado rápido. Os números de telefone devem ser transmitidos no formato E.164 e uma especificação OpenAPI legível por máquina é inserida diretamente no Postman ou num gerador de código.
Para envios em massa de grande volume, o endpoint de envio de modelos aceita um parâmetro de limitação por hora, de modo que o Flowella controla o ritmo da entrega no lado do servidor, em vez de ser você a controlar as solicitações.
Reagir a eventos em tempo real
Inscreva-se nos eventos que lhe interessam e a Flowella envia uma notificação assim que estes ocorrem.
| Evento | Quando é disparado |
|---|---|
| message.received | Chega uma mensagem recebida do WhatsApp de um contacto |
| message.sent | O Flowella aceitou a sua mensagem de saída e enviou-a para a Meta |
| message.delivered | A Meta confirmou a entrega no dispositivo do destinatário |
| message.read | O destinatário abriu a mensagem |
| message.failed | O Meta devolveu uma falha para a mensagem |
| conversation.opened / closed | Uma conversa mudou de estado |
| optout.created | Um contacto optou por sair de um canal |
| template.status_updated | O Meta alterou o estado de um modelo |
Cada pedido é assinado com um resumo hexadecimal HMAC-SHA256 do corpo bruto, por isso verifique a assinatura antes de processar. O Flowella aguarda até dez segundos por um 2xx, tenta novamente até três vezes com backoff e desativa automaticamente um ponto final após dez falhas consecutivas. Como as tentativas podem repetir um evento, use o ID do evento como uma chave de idempotência e trate as duplicatas como no-ops.
Primeiro sem código; recorra ao código quando for necessário.
A API amplia as funcionalidades do produto. Não substitui as funcionalidades que já funcionam sem código.
Comece aqui para os empregos mais comuns.
A maior parte das necessidades das equipas, como o envio de modelos, a captura de respostas do fluxo, o acionamento da automatização, já está coberta sem tocar na API. Só procure o código quando precisar de algo mais.
- Formulário para fluxo, sincronização nativa do HubSpot
- Acções de fluxo de trabalho e a caixa de entrada
- Não há código para escrever
Procurem o código quando precisarem de mais.
Quando precisar de ligar o WhatsApp a um sistema personalizado, sincronizar com uma ferramenta sem conetor nativo ou reagir a eventos no seu próprio backend, a API e os webhooks dão-lhe controlo total.
- Aplicações personalizadas e integrações por medida
- Reagir a eventos sem sondagem
- Envios em massa com limitação do lado do servidor
- ⏱️ 30 seconds · Card on file
- 👤 With · Membership team
- 📩 Receipt sent here after renewal
Choose your plan
- 🏆 Annual · £49 ✓
- 🎯 Quarterly · £15 ✓
- 📅 Monthly · £6 ✓
Powered by Flowella · Secure renewal
Respostas diretas.
As perguntas que os programadores fazem.
Como é que me autentico?
Uma chave de portador válida para toda a organização, criada em «Definições», «Chaves API» por um Proprietário ou Administrador. É apresentada apenas uma vez no momento da criação; por isso, guarde-a em segurança e substitua-a quando os colegas de equipa saírem da organização.
O que é que a API pode fazer?
Envie mensagens e modelos do WhatsApp, faça a gestão de contactos e cancelamentos de subscrição, crie listas e envie modelos em massa, e obtenha dados analíticos. A lista completa de pontos de extremidade é gerada automaticamente a partir da especificação OpenAPI.
Posso efetuar grandes envios em massa?
Sim. Utilize o endpoint de envio de modelos com um parâmetro de limitação por hora e a Flowella controla o ritmo do lado do servidor, pelo que não precisa de gerir manualmente os limites de tempo ou de frequência de envio.
Como é que verifico se um webhook é genuíno?
Cada webhook é assinado com um resumo HMAC-SHA256 do corpo da solicitação em formato bruto. Calcule o mesmo resumo com o seu segredo de assinatura e compare, assinando os bytes em formato bruto antes de qualquer análise JSON.
E se o meu ponto final estiver em baixo?
O Flowella tenta novamente até três vezes com intervalos de espera e desativa automaticamente o ponto de extremidade após dez falhas consecutivas. Reative-o em «Definições», «Webhooks» assim que o seu ponto de extremidade estiver corrigido.
Como é que evito processar duplicados?
Utilize o ID do evento como chave de idempotência, mantenha um cache de curta duração das chaves processadas e trate as repetições como operações sem efeito. As tentativas de repetição significam que o mesmo evento pode chegar mais do que uma vez.
Leia a documentação para programadores
Todo o conteúdo desta página, incluindo a referência completa e os exemplos de código, está disponível na documentação.
A referência completa para programadores encontra-se na base de conhecimento.
A introdução à API abrange o URL base, a autenticação, os erros, a paginação, os limites de taxa e a especificação OpenAPI.
Os webhooks de saída abrangem a configuração de um webhook, a lista completa de eventos, a verificação de assinatura, as tentativas de repetição e a idempotência, com exemplos de código.
Desenvolva a partir do mesmo motor, à sua maneira.
