Digite para filtrar os verbetes do Glossário.

    Automação e integrações · n8n Experts

    O que é Cloud API?

    Cloud API é o caminho oficial da Meta para integrar o WhatsApp a sistemas. Entenda envio, aviso de status, janela de atendimento e cobrança por mensagem.

    Também chamado de: WhatsApp Cloud API, API oficial do WhatsApp, WhatsApp Business Platform

    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

    Aplicaçã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
    Capa da formação n8n Experts

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano