Documentacao Markaut

WhatsApp API Oficial (Meta)

Premium

A WhatsApp Business API (API Oficial da Meta) e a solucao oficial para empresas que desejam utilizar o WhatsApp como canal de atendimento em larga escala, com total conformidade com as politicas da Meta.

O Que E e Como Funciona

A conexao com a API Oficial do WhatsApp e feita diretamente com os servidores da Meta, garantindo:

	Beneficio	Descricao
	Conformidade total	Sua empresa opera dentro das regras oficiais do WhatsApp
	Maior entregabilidade	Mensagens tem prioridade na entrega pelos servidores oficiais
	Reputacao do numero	O numero e verificado e tem selo de confianca (marca verde)
	Mensagens template (HSM)	Envie mensagens pre-aprovadas fora da janela de 24h
	Sessao de atendimento	Janela de 24 horas para responder gratuitamente

Pre-requisitos

Para utilizar a API Oficial, sua empresa precisa de:

1
Conta no Facebook Business — Necessaria para gerenciar o numero
2
Numero de telefone dedicado — Nao pode ser usado no WhatsApp normal (pode ser portado)
3
Verificacao do numero — O numero precisa ser verificado pela Meta
4
Token de Acesso Permanente — Gerado pelo Facebook Developers e configurado na Markaut

Processo de Conexao

Criar Aplicativo no Facebook Developers

Acesse developers.facebook.com
Crie um novo aplicativo do tipo Business
Adicione o produto WhatsApp ao seu aplicativo

Configurar o Numero e Webhook

Adicione seu numero de telefone no painel WhatsApp
Complete a verificacao via SMS ou chamada
Configure o Webhook apontando para sua instancia Markaut

Gerar Token de Acesso

No Facebook Developers, acesse a secao de tokens
Gere um Token de Acesso Permanente
Copie o token — ele sera usado apenas uma vez

Conectar na Markaut

Acesse Canais → Adicionar Canal
Selecione WhatsApp API Oficial
Cole o Token de Acesso Permanente e salve

Recursos Disponiveis

Mensagens Template (HSM)

Envie mensagens pre-aprovadas para iniciar conversas com clientes fora da janela de 24 horas. Ex: notificacoes de pedido, lembretes, confirmacoes.

Botoes Interativos

Crie botoes de acao rapida, CTA (link/telefone) e listas com ate 10 opcoes para facilitar a navegacao do cliente.

Mensagens Multimidia

Envie e receba texto formatado, imagens, videos, documentos, audio, localizacao e contatos.

Vantagens da API Oficial

Escalabilidade empresarial — Suporte a milhares de conversas simultaneas

Numero verificado — Selo verde de verificacao do WhatsApp Business

Sem risco de bloqueio — Por ser oficial, nao ha risco de banimento

Suporte a multiplos atendentes — Sem limitacao de usuarios por numero

Integracao com CRM — Via webhooks e API da Markaut

Limitacoes

Requer um numero dedicado (nao pode estar no WhatsApp normal)

Mensagens template precisam de aprovacao previa da Meta

Custo por conversa iniciada pela empresa (fora da janela de 24h)

Processo de aprovacao do numero pode levar alguns dias

Custos (Modelo da Meta)

O WhatsApp cobra por conversa iniciada pela empresa fora da janela de 24 horas. Conversas iniciadas pelo cliente sao gratuitas nas primeiras 24 horas.

Tipo de Conversa	Custo
Iniciada pelo cliente (24h)	Gratuito
Marketing	Varia por regiao
Utilidade (notificacoes)	Varia por regiao
Atendimento	Varia por regiao

Tech Provider

Para utilizar a API Oficial, voce precisa de um tech provider aprovado pela Meta. A Markaut atua como tech provider e gerencia toda a parte tecnica para voce.

Colecoes Postman

Baixe as colecoes do Postman para testar os endpoints da API oficial Markaut.

API Oficial (Modelo)API Admin

Command Palette