Conectar o ManyChat

Com o ManyChat conectado, cada evento de venda do Vipter encontra o contato do comprador no ManyChat, ou cria um novo, preenche os campos personalizados que você criou, aplica as tags e dispara o fluxo que você escolheu para aquele evento. Um PIX gerado pode virar a tag pix-pendente e um fluxo de lembrete com o código copia e cola, por exemplo.

Antes de começar, vale ler como funcionam as automações.

Passo 1: gerar o token da API no ManyChatCopiar link da seção

1. No ManyChat, abra Settings›API (Configurações › API).
2. Gere um token e copie. Ele tem o formato 1234567:a1b2c3….

Passo 2: criar os campos personalizados no ManyChatCopiar link da seção

O Vipter preenche os campos personalizados do ManyChat que têm o mesmo nome de um campo do registro de venda. Crie no ManyChat só os que os seus fluxos vão usar. Os mais comuns:

O nome precisa ser igual; maiúsculas e minúsculas não fazem diferença. Um campo que não existe no ManyChat não é enviado, e um valor vazio não apaga o que o campo já tem. Um valor que não cabe no tipo do campo também fica de fora: valor num campo do tipo Número, por exemplo. Para números, use valor_decimal.

Passo 3: conectar no VipterCopiar link da seção

1. No painel do Vipter, abra Geral›Integrações›Automações›ManyChat.
2. Em Conexão, preencha os campos numerados.

3. Em Tags e fluxos por evento, informe o que cada evento faz no ManyChat. Veja o formato logo abaixo.
4. Em Eventos enviados, desmarque o que você não quer enviar.
5. Deixe ligado Ativo — enviar eventos para esta plataforma, clique em Salvar e depois em Testar conexão.

Como escrever as tags e o fluxoCopiar link da seção

Cada campo aceita nomes de tags separados por vírgula e, para disparar um fluxo, flow: seguido do código do fluxo. O código é o final do endereço do fluxo no ManyChat, como content20241001120000_123456.

Uma tag que ainda não existe no ManyChat é criada na hora. Os eventos sem valor próprio usam o Tags e fluxo padrão. Sem nenhum valor, o contato e os campos são atualizados mesmo assim, o que já basta para uma regra do ManyChat que dispara quando um campo muda.

Passo 4: usar tags e fluxo por oferta (opcional)Copiar link da seção

Faça este passo quando um produto precisa de uma tag ou de um fluxo só dele.

1. Em Tags por oferta, escolha a Oferta.
2. Informe as Tags e fluxo, como curso-x ou curso-x, flow:content20241001123000_678901.
3. Clique em Adicionar regra.

As tags da regra se somam às tags do evento. Se a regra tiver um flow:, esse fluxo é disparado no lugar do fluxo do evento. A regra vale em todos os eventos da oferta, e também para as outras ofertas do mesmo produto. Por exemplo: com pix-pendente, flow:…_123456 no PIX gerado e a regra curso-x na oferta, um PIX gerado do Curso X recebe as tags pix-pendente e curso-x e dispara o fluxo do PIX.

O que acontece a cada eventoCopiar link da seção

1. Contato: o Vipter procura o contato pelo telefone e depois pelo e-mail. Se não encontrar, cria um contato com o nome, o número no WhatsApp e o e-mail. O e-mail entra sem consentimento de marketing, porque o checkout não coleta esse consentimento, e o número não entra como SMS. Um contato que já existe não tem o nome nem as permissões alterados.
2. Campos: os campos personalizados com nome de campo da Vipter recebem os valores do evento.
3. Tags: as tags do evento, mais as da regra da oferta.
4. Fluxo: o fluxo da regra da oferta, se ela tiver um, ou o do evento.

Os campos vêm antes do fluxo, para que a mensagem do fluxo já mostre o código do PIX ou o rastreio. As tags nunca são removidas: use tags de estorno ou cancelamento nas suas automações do ManyChat.

Envios, novas tentativas e reenvioCopiar link da seção

Cada evento aparece em Envios recentes:

• enviado: contato encontrado ou criado, campos, tags e fluxo aplicados. Um campo que o ManyChat recusou não muda o status: o envio continua como enviado.
• ignorado: a venda não tem telefone nem e-mail (customer has no phone and no e-mail).
• falhou: uma etapa falhou. O motivo começa pelo nome da etapa, como addTagByName "cliente", sendFlow … ou createSubscriber. Falhas passageiras, como o ManyChat fora do ar ou limite de chamadas, ganham novas tentativas automáticas. Uma recusa do ManyChat, como um fluxo que não existe, não é repetida.

Depois de corrigir a causa, use Reenviar. Veja novas tentativas e reenvio.

Problemas comunsCopiar link da seção

• A plataforma recusou as credenciais com "this ManyChat account is not Pro"

  A conta do ManyChat não está no plano Pro. A API só funciona no Pro.

• O campo personalizado não foi preenchido

  Confira se o nome é igual ao do campo da Vipter, como pix_copia_e_cola, e se o tipo aceita o valor. O campo também fica como está quando o evento não tem aquele dado: um PIX gerado não tem rastreio, por exemplo.

• O envio falhou em sendFlow

  O código do fluxo está errado ou o fluxo não está publicado. Copie de novo o final do endereço do fluxo e confira o flow: no valor do evento ou da regra.

• O envio falhou em createSubscriber dizendo que o contato já existe

  O contato existe no ManyChat só com o WhatsApp, e a busca pelo telefone não o encontrou. Confira se o número no ManyChat tem o código do país. Depois, use Reenviar.

O que fazer a seguirCopiar link da seção

• Veja todos os campos do registro de venda.
• Entenda os valores por evento e as regras por oferta.