Como conectar suas aplicações à API do WhatsApp Business
Conteúdo
Conectar suas aplicações, CRM ou plataforma e-commerce à API do WhatsApp Business permite enviar e receber mensagens WhatsApp a partir dos seus sistemas: notificações de pedido, respostas de suporte e campanhas em um só lugar. Com a Spoki você tem um caminho simples para acesso API, webhooks e gestão de modelos para a integração ficar em conformidade e escalável.
Este guia explica como conectar suas aplicações à API do WhatsApp Business, o que você precisa (conta, modelos, webhooks) e como a Spoki ajuda. Você encontra links para registro, preços, suporte e a calculadora de ROI.
O que você precisa antes de conectar
Checklist:
- Acesso à API do WhatsApp Business (ex.: via Spoki). Você precisa de um negócio verificado e um número de telefone para WhatsApp.
- Modelos aprovados para mensagens de saída fora da sessão de 24 horas. A Spoki orienta na criação e aprovação dos modelos.
- Opt-in: envie mensagens apenas para usuários que aceitaram receber WhatsApp. Guarde o consentimento no CRM ou na Spoki. Ver registro e suporte para fluxos de consentimento.
- Uma aplicação ou sistema que possa enviar requisições HTTP (ex.: REST API) ou receber webhooks. A maioria dos CRMs, plataformas e-commerce e apps custom suportam isso.
A Spoki fornece a camada API e os endpoints webhook para você conectar suas ferramentas sem construir tudo do zero. Consulte preços e agendar para o seu caso de uso.
Como a API do WhatsApp Business e a Spoki funcionam juntas
A API do WhatsApp Business tem duas formas principais de suas aplicações interagirem:
A Spoki fica entre suas aplicações e a API do WhatsApp Business: você conecta seu CRM, e-commerce ou código custom à Spoki, e a Spoki cuida de modelos, sessões e opt-in para você ficar em conformidade. Use registro para começar e suporte para a integração.
Passo a passo: conectar sua aplicação com a Spoki
1. Criar conta Spoki e conectar WhatsApp
Conclua o registro e vincule seu número WhatsApp Business. A Spoki orienta na verificação do negócio e no envio dos modelos para você enviar mensagens aprovadas.
2. Obter credenciais API e URL do webhook
Na Spoki você obtém credenciais API (ou configuração webhook) para enviar mensagens e receber eventos entrantes. Sua aplicação chama a Spoki para enviar modelos ou mensagens de sessão, e a Spoki pode encaminhar mensagens entrantes para a sua URL webhook para sua aplicação reagir (ex.: registrar no CRM, responder automaticamente).
3. Implementar envio e recepção na aplicação
- Envio: Quando sua aplicação precisar enviar uma mensagem WhatsApp (ex.: pedido confirmado, resposta de suporte), ela chama a API da Spoki com o nome do modelo e os parâmetros ou o conteúdo da mensagem de sessão. A Spoki cuida da entrega e das regras de 24 horas.
- Recepção: Configure o webhook na Spoki para que as mensagens entrantes sejam enviadas à sua aplicação. Sua aplicação interpreta o evento, atualiza o banco ou o CRM e pode disparar uma resposta via Spoki dentro da janela de sessão. Ver agendar e suporte para exemplos.
4. Respeitar opt-in e modelos
Envie apenas para usuários que deram opt-in. Para a primeira mensagem ou após 24 horas de inatividade use apenas modelos aprovados. A Spoki ajuda a gerenciar opt-in e modelos para a integração da aplicação ficar dentro das políticas do WhatsApp. A calculadora de ROI ajuda a estimar volume e custo.
Casos de uso comuns: CRM, E-commerce, Suporte
- CRM: Seu CRM envia à Spoki uma requisição quando um lead faz opt-in ou quando você quer enviar uma campanha modelo. As mensagens entrantes chegam ao CRM via webhook para os agentes verem o fio completo. A Spoki e o CRM mantêm opt-in e lógica de sessão sincronizados. Links: registro, preços.
- E-commerce: Confirmação de pedido, atualização de envio ou follow-up de suporte: sua plataforma e-commerce chama a Spoki para enviar modelos ou mensagens de sessão. As mensagens entrantes (ex.: “Onde está meu pedido?”) chegam ao seu webhook; sua aplicação pode responder via Spoki em 24 horas. Use suporte e agendar para desenho.
- Suporte: As mensagens WhatsApp recebidas são entregues à sua aplicação via webhook. Sua aplicação pode atribuir o chat a um agente, mostrar o histórico do CRM e enviar respostas pela Spoki enquanto a sessão estiver ativa. Após 24 horas a próxima mensagem de saída deve ser um modelo. A Spoki mantém isso claro para sua aplicação não quebrar as regras.
Erros a evitar
- Enviar sem opt-in: Sua aplicação só deve enviar para usuários que consentiram. A Spoki ajuda a armazenar e checar opt-in para a lógica API ou webhook ficar em conformidade.
- Usar texto livre na primeira mensagem ou após 24 h: A API exige modelos aprovados nesses casos. Sua aplicação deve chamar a Spoki com o nome do modelo e os parâmetros corretos; a Spoki cuida do resto.
- Ignorar a segurança do webhook: Valide as requisições webhook (ex.: assinatura ou token) para que apenas a Spoki possa enviar à sua aplicação. A Spoki e o suporte podem orientar.
- Não tratar opt-out: Quando um usuário enviar STOP, sua aplicação deve processar (ex.: atualizar CRM, parar envios). A Spoki pode encaminhar eventos opt-out ao seu webhook para sua aplicação ficar em conformidade. Ver preços e registro para escalar.
Conclusão
Conectar suas aplicações à API do WhatsApp Business com a Spoki dá a você uma única camada API e webhook para modelos, mensagens de sessão e opt-in. Seu CRM, e-commerce ou aplicação custom pode enviar e receber WhatsApp enquanto a Spoki mantém você nas regras.
Pronto para conectar suas aplicações? Acesse Spoki para a API do WhatsApp Business, registro e preços. Use a calculadora de ROI para planejar sua integração e suporte ou agendar para ajuda técnica.
