Skip to content

WhatsApp Oficial (Cloud API)

Visao Geral

O Paralela suporta a integracao com a API oficial do WhatsApp (Cloud API da Meta), oferecendo uma conexao mais estavel e recursos avancados em comparacao ao metodo por QR Code.

Principais vantagens:

  • Conexao permanente sem quedas de sessao
  • Suporte a templates de mensagem para envios fora da janela de 24 horas
  • Coexistencia (Coex): use o WhatsApp Business App no celular ao mesmo tempo
  • Registro de chamadas perdidas no historico do ticket
  • Suporte completo a todos os tipos de mensagem: texto, imagens, video, audio, documentos, contatos, localizacao, reacoes e stickers

Diferenca entre QR Code e API Oficial

CaracteristicaQR CodeAPI Oficial
ConexaoEscanear QR CodeCadastro via Meta Business
EstabilidadePode desconectarConexao permanente
TemplatesNao suportaSuporta (obrigatorio fora da janela de 24h)
CoexistenciaNaoSim (usar WhatsApp Business App no celular ao mesmo tempo)
ChamadasNao registraRegistra chamadas perdidas
ReacoesLimitadoSuporta reacoes com emojis
LocalizacaoLimitadoEnvia e recebe localizacao

Requisitos

Para conectar via API Oficial, voce precisa de:

  • Uma conta Meta Business (business.facebook.com)
  • Um numero de telefone dedicado (ou compartilhado via Coex)
  • Um Facebook App com credenciais (App ID e App Secret) configuradas pelo administrador do sistema

Conectando via Cadastro Integrado (Coex)

Este e o metodo mais simples para conectar um numero a API oficial. O fluxo de cadastro e guiado pela propria Meta.

  1. Acesse Conexoes no menu lateral
  2. Clique em Adicionar Conexao
  3. Selecione WhatsApp Oficial como tipo de conexao
  4. Clique em Cadastro Integrado (ou Conectar via Coex)
  5. Siga o fluxo de cadastro da Meta que abre automaticamente
  6. Cadastre ou selecione seu numero de telefone
  7. Aguarde a verificacao e ativacao
  8. A conexao aparece como Conectado

Conectando via OAuth (Meta Business)

Metodo alternativo para quem ja possui uma conta WhatsApp Business (WABA) configurada na Meta.

  1. Acesse Conexoes no menu lateral
  2. Clique em Adicionar Conexao e selecione WhatsApp Oficial
  3. Clique em Conectar com Facebook
  4. Autentique com a conta que gerencia o Meta Business
  5. Autorize as permissoes solicitadas
  6. Selecione a conta WhatsApp Business (WABA) e o numero desejado
  7. Conexao ativada

Templates de Mensagem

O que sao

Templates sao formatos de mensagem pre-aprovados pela Meta, obrigatorios para enviar mensagens fora da janela de conversa de 24 horas. Quando um cliente envia uma mensagem, voce tem 24 horas para responder livremente. Apos esse periodo, so e possivel iniciar contato usando um template aprovado.

Categorias

CategoriaUso
MarketingPromocoes, ofertas, novidades
UtilidadeConfirmacoes, atualizacoes, lembretes
AutenticacaoCodigos de verificacao, senhas temporarias

Sincronizando Templates

  1. Acesse Conexoes no menu lateral
  2. Selecione a conexao WhatsApp Oficial desejada
  3. Clique em Sincronizar Templates
  4. Os templates aprovados na Meta Business serao importados automaticamente

Status dos Templates

StatusSignificado
AprovadoPronto para uso
PendenteEm analise pela Meta
RejeitadoNao aprovado, precisa de ajustes e reenvio
DesativadoDesativado pela Meta

Usando Templates

  • Ao enviar mensagem fora da janela de 24 horas, o sistema solicita a selecao de um template
  • Preencha as variaveis dinamicas (nome, data, valor, etc.)
  • O template e enviado conforme o formato aprovado pela Meta

Recursos Exclusivos

Coexistencia (Coex)

O modo de coexistencia permite usar o WhatsApp Business App no celular ao mesmo tempo que o numero esta conectado ao Paralela.

  • Mensagens enviadas pelo app aparecem no Paralela
  • Mensagens enviadas pelo Paralela aparecem no app
  • Ideal para equipes que precisam do celular em campo

Chamadas Perdidas

Chamadas de voz recebidas sao registradas automaticamente como um log no ticket do contato.

  • Permite acompanhar tentativas de contato por ligacao
  • O registro aparece no historico da conversa

Reacoes

  • Clientes podem reagir a mensagens com emojis
  • As reacoes aparecem no historico da conversa em tempo real

Localizacao

  • Envie e receba mensagens de localizacao diretamente pelo chat
  • Localizacoes recebidas incluem um link para o Google Maps

Filas e Distribuicao

A distribuicao de conversas funciona da mesma forma que no WhatsApp QR Code. Voce pode vincular filas a conexao, configurar distribuicao automatica entre atendentes e definir saudacoes com I.A. Consulte a documentacao de WhatsApp para mais detalhes sobre filas e distribuicao.


Integracao com I.A.

Os mesmos assistentes de I.A. disponiveis no WhatsApp QR Code funcionam com a API Oficial. Mensagens de audio podem ser transcritas automaticamente. Consulte a documentacao de Assistentes I.A. para mais detalhes.

Documentação oficial da plataforma Paralela