Integração com a Meta (WhatsApp Business)

A integração com a Meta permite conectar um número de WhatsApp Business ao Tyxter Studio, possibilitando que os agentes enviem e respondam mensagens automaticamente.

warning

Sem essa integração, o agente não consegue operar no WhatsApp.

Pré-requisitos

1. Business Manager (Meta)

Conta empresarial da Meta necessária para gerenciar o WhatsApp Business API.

Caso não exista, crie em: business.facebook.com/create

2. Número de WhatsApp Business

• Deve ser um número válido para WhatsApp Business (API oficial)
• Números pessoais não funcionam
• O número precisa ser exclusivo (não pode estar ativo em WhatsApp comum)

Opções: usar número próprio já configurado ou comprar via provedores.

Processo de Integração

Etapa 1 — Acessar Integrações

Ir em Configurações → Integrações e clicar em Conectar via Facebook.

Link direto: tyxter.dev/settings?tab=integrations

Etapa 2 — Autenticação com Meta

1. Abrirá um popup da Meta
2. Fazer login na conta
3. Selecionar Business Manager (portfólio empresarial)
4. Selecionar conta do WhatsApp Business (ou criar dentro do fluxo)

Etapa 3 — Configuração da Conta

Preencher:

• Nome da conta
• Categoria
• Website

Parte das informações pode ser puxada automaticamente do Business Manager.

Etapa 4 — Adicionar Número

1. Inserir número com DDD
2. Receber SMS no número configurado
3. Inserir código de confirmação na Meta

warning

Sem validação do SMS, a integração não é concluída.

Etapa 5 — Permissões

Revisar permissões solicitadas pela Meta e confirmar conexão com o Tyxter Studio.

Etapa 6 — Finalização

Concluir integração dentro do Tyxter Studio e aguardar processamento. O número aparecerá como conectado na plataforma.

Publicação do Agente

Após integração concluída:

1. Ir até o app/agente
2. Acessar Instalação
3. Selecionar o número conectado
4. Atribuir ao agente
5. Clicar em Publicar

O agente passa a responder mensagens no WhatsApp.

Configuração de Perfil

Alterações de perfil não são feitas no Tyxter Studio. Devem ser feitas no Business Manager da Meta:

• Foto de perfil
• Nome do número
• Categoria
• Descrição

Caminho: Business Manager → Conta do WhatsApp

Templates de Mensagem

Para uso de templates (notificações, mensagens ativas):

• Necessário configurar dentro da Meta
• Pode exigir aprovação e forma de pagamento vinculada

Veja mais em Templates de Mensagem.

Problemas Comuns

Problema	Causa provável
Número não conecta	Código SMS não validado ou número já em uso em outro WhatsApp
Business Manager não aparece	Usuário sem permissão ou conta não criada
Agente não responde	Número não atribuído ao agente ou agente não publicado