O que é a Cloud API
A Cloud API é o caminho oficial da Meta para integrar o WhatsApp a sistemas. O painel de atendimento, o conector e a automação acrescentam componentes a essa conexão, mas o envio e o recebimento passam pela plataforma oficial.
Você usa a Cloud API quando quer que a mensagem saia pela estrutura da Meta, com o histórico de status disponível para a sua integração. A escolha do fornecedor não substitui a necessidade de configurar o número, as permissões e o acompanhamento das respostas.
Envio e confirmação de entrega
O envio de uma mensagem devolve dois momentos diferentes: o aceite confirma que a plataforma recebeu a solicitação, e a confirmação de chegada vem depois, como um aviso de status enviado ao seu sistema.
Essa distinção muda a leitura do painel. Uma mensagem entregue dispensa reenvio, enquanto uma falha registrada permite investigar o motivo apresentado. Repetir o texto quando não há confirmação pode duplicar a comunicação.
O aviso de status chega por webhook
O webhook é a notificação que a plataforma transmite à sua integração. Ele informa se a mensagem foi enviada, entregue, lida ou falhou, e o painel precisa associar cada aviso à mensagem correspondente.
Uma ausência de atualização também merece investigação, porque a integração pode ter enviado a resposta e falhado ao registrar o retorno. O n8n costuma receber esse aviso e atualizar o atendimento a partir dele, distinguindo a solicitação de envio do estado de entrega.
Janela de atendimento e templates
A resposta livre depende da janela de atendimento, reiniciada quando o cliente envia uma mensagem. Fora desse período, o envio usa um template de mensagem aprovado, com o consentimento do destinatário.
Esse limite afeta a retomada de uma conversa interrompida. Depois de resolver a falha, você confere se ainda pode responder pela janela ou se o contato exige um modelo aprovado, considerando também o horário da conversa.
Tarifa e suporte contratado
A cobrança por mensagem é uma linha do orçamento, ao lado da assinatura da plataforma e do processamento do agente. Uma mensalidade menor pode exigir trabalho manual para reconectar o número ou investigar falhas, e esse tempo entra no custo do atendimento.
Na avaliação de um fornecedor, confira qual empresa atende você quando o painel apresenta erro e como ela acessa o histórico de execução. Usar uma credencial de integração não amplia o que o atendente pode ver, porque o acesso continua restrito ao perfil configurado.
Dúvidas frequentes
Perguntas frequentes sobre Cloud API
- Cloud API e WhatsApp Web são a mesma coisa?
- Não. A Cloud API usa a conexão oficial da plataforma e atende chamadas de sistemas. Uma integração que automatiza o WhatsApp Web depende da sessão daquele conector, com outro comportamento de reconexão e suporte.
- O aceite do envio comprova a entrega?
- Não. O aceite confirma que a plataforma recebeu a tentativa. A confirmação de chegada vem depois, por um aviso de status enviado ao sistema. Você precisa acompanhar esse retorno para saber se a mensagem chegou.
- Preciso de template para toda resposta?
- Não. Dentro da [janela de atendimento](/glossario/janela-de-atendimento/), a resposta livre é possível. Fora desse período, o envio depende de um [template de mensagem](/glossario/template-de-mensagem/) aprovado e do consentimento do destinatário.
- A tarifa é a única despesa?
- Não. A cobrança por mensagem é uma parte. A assinatura da plataforma de atendimento e o processamento do agente, quando existe, seguem como despesas próprias, conforme o serviço contratado.
Para continuar
Recursos relacionados
Documentação
Meta: WhatsApp Cloud API
Apresenta a conexão oficial, os componentes da integração e os recursos disponíveis para sistemas.
Abrir recursoDocumentação
Meta: primeiros passos na Cloud API
Orienta a configuração inicial, o envio de uma mensagem e o recebimento dos avisos de status.
Abrir recursoDocumentação
Meta: preços do WhatsApp Business Platform
Reúne as categorias de mensagem, a franquia de serviço e as tarifas por mercado.
Abrir recursoAplicação na formação
n8n Experts
A Cloud API é a conexão oficial usada nas automações de atendimento construídas com o n8n.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.