Solução de problemas com a ManyMoney AI

Este guia explica como solucionar problemas com a ManyMoney AI. Quando você fornece informações estruturadas em seus prompts, a ManyMoney AI pode diagnosticar mais rápido e sugerir correções mais precisas.

Dica

Se precisar de suporte humano, você pode enviar um ticket para o Suporte da Pushwoosh.

O que a ManyMoney AI pode inspecionar

A ManyMoney AI usa as APIs da Pushwoosh para inspecionar:

Categoria	O que inspeciona
Journey	Configuração e validação, estatísticas por ponto da journey, fluxo do usuário para um usuário específico
Entrega de mensagens	Logs de rastreamento para status de entrega e códigos de erro, estatísticas de mensagens e campanhas, relatórios de entrega e de erros
Usuários e dispositivos	Registro e status do dispositivo, tags de usuário, compilação e tamanho do segmento
Configuração	Configurações de aplicativo e plataforma, predefinições (push, e-mail, etc.), lógica de segmento e evento

Como a ManyMoney AI diagnostica problemas

Quando você descreve um problema, a ManyMoney AI:

1. Coleta informações de diagnóstico usando as APIs da Pushwoosh e os dados do seu projeto.
2. Verifica múltiplos pontos de falha (configuração da journey, predefinições, segmentos, configurações da plataforma).
3. Identifica a causa raiz a partir de padrões nos dados.
4. Sugere uma resolução passo a passo e explica por que o problema ocorreu para que você possa evitá-lo no futuro.

O que esperar do diagnóstico da ManyMoney AI

Na resposta que você recebe:

• Problema principal e estado atual do seu projeto
• Por que não está funcionando e opções de correção (com prós e contras)
• Quaisquer problemas adicionais encontrados
• Para ações que alteram sua conta, a ManyMoney AI solicita confirmação explícita antes de prosseguir

Tempo de resposta: Normalmente de 10 a 30 segundos para um diagnóstico completo.

O que fazer e o que não fazer ao solucionar problemas com a ManyMoney AI

Inclua os detalhes corretos em seu prompt para que a ManyMoney AI possa diagnosticar eficazmente. Quanto mais preciso e completo for o seu prompt, mais rápido você chegará a uma solução.

Fazer	Não fazer
Copie as mensagens de erro exatas em vez de parafrasear.	Parafraseie os erros (por exemplo, “disse algo sobre inválido”).
Inclua os URLs da journey (copie do seu navegador quando a journey ou o recurso estiver aberto) para que o ID da Journey e os nomes possam ser extraídos deles.	Presuma que a ManyMoney AI conhece sua configuração (“a configuração usual”).
Especifique o fuso horário quando o problema envolver tempo ou agendamento (por exemplo, UTC, Europe/Moscow).	Omita a plataforma (iOS, Android, Web, etc.).
Compartilhe datas relevantes (por exemplo, “começou na segunda-feira” ou “desde que atualizamos em 15 de janeiro”).	Diga “não funciona” sem descrever o comportamento esperado versus o real.
Mencione o que você já tentou para que etapas repetidas possam ser puladas.	Misture vários problemas não relacionados em um único prompt.

Faça o acompanhamento na mesma conversa

Alguns problemas precisam de várias rodadas. Mantenha a mesma conversa e adicione cada nova descoberta para que a ManyMoney AI possa construir a partir dela.

Modelos de prompt por tipo de problema

Use os modelos abaixo como listas de verificação para que seu prompt tenha tudo o que a ManyMoney AI precisa para o diagnóstico. Para encontrar identificadores, consulte Principais identificadores da API.

Entrega de notificações push

Use quando: As notificações push não são entregues no iOS, Android ou Web.

Inclua estes detalhes em seu prompt para a ManyMoney AI:

Incluir no prompt	Exemplo ou formato
Plataforma	iOS, Android ou Web
Journey	ID da Journey ou URL completo do Painel de Controle, se aplicável
Quando começou	Data e hora, ou “nunca funcionou”
Erro	Mensagem exata, se houver
Dispositivo de teste	ID de Hardware (HWID) se estiver testando em um dispositivo específico
Esperado	O que deveria acontecer
Real	O que acontece em vez disso

Exemplo de prompt

As notificações push para iOS não estão sendo entregues na journey “Welcome Flow”.

• Journey: https://app.pushwoosh.com/journeys/{APP_CODE}/{STATUS}/{JOURNEY_UUID}
• Começou: Ontem às 14h
• Erro: Os usuários aparecem nas estatísticas da journey, mas nenhum push é recebido
• HWID do dispositivo de teste: test-iphone-12-hwid
• Esperado: Push enviado logo após o registro do usuário
• Real: O usuário entra na journey, mas nenhuma notificação aparece

Entrega de e-mail

Use quando: Os e-mails não são entregues ou retornam (bounce).

Inclua estes detalhes em seu prompt para a ManyMoney AI:

Incluir no prompt	Exemplo ou formato
Campanha ou journey	Nome ou UUID
Modelo de e-mail	Nome ou código de conteúdo do e-mail
Endereço do remetente	remetente@seudominio.com
Verificação de domínio	Verificado, não verificado ou desconhecido
Quem é afetado	Todos os usuários, um segmento ou apenas e-mails de teste
Tipo de bounce	Hard, soft, reclamação ou desconhecido
Quando começou	Data ou “nunca funcionou”
E-mail de teste	teste@exemplo.com se estiver testando

Exemplo de prompt

Os e-mails não estão sendo entregues na journey “Abandoned Cart”.

• Journey: https://app.pushwoosh.com/journeys/{APP_CODE}/{STATUS}/{JOURNEY_UUID}
• Modelo de e-mail: “Cart Reminder Day 1”
• De: noreply@minhaloja.com
• Verificação de domínio: Mostra “NOT READY”
• Destinatários: Todos os usuários
• Começou: Hoje, quando a journey foi lançada

Customer journey não está funcionando

Use quando: Uma journey não mostra atividade ou mostra atividade inesperada.

Inclua estes detalhes em seu prompt para a ManyMoney AI:

Incluir no prompt	Exemplo ou formato
Nome da journey, URL ou UUID	URL completo ou ID da Journey
Status	Rascunho, Inativa, Ativa, Pausada ou Arquivada
Tipo de entrada	Baseada em gatilho, baseada em público ou baseada em API
Evento ou segmento de entrada	Nome do evento ou Nome do segmento
Usuários esperados	Número aproximado ou “deveriam ter entrado”
Intervalo de datas	Período que você está analisando nas estatísticas
Última alteração	Se você alterou algo recentemente

Exemplo de prompt

A customer journey não mostra atividade.

• Journey: “Black Friday 2024 Campaign”
• URL: https://app.pushwoosh.com/journeys/{APP_CODE}/{STATUS}/{JOURNEY_UUID}
• Status: Ativa (iniciada há 2 dias)
• Tipo de entrada: Baseada em gatilho
• Evento de entrada: “AddToCart”
• Esperado: Pelo menos 100 usuários deveriam ter entrado
• Intervalo de datas: Últimos 7 dias
• Última modificação: O horário de envio foi alterado ontem

Problemas de segmentação

Use quando: Um segmento não corresponde aos usuários esperados.

Inclua estes detalhes em seu prompt para a ManyMoney AI:

Incluir no prompt	Exemplo ou formato
Nome do segmento	Nome do segmento como mostrado no Painel de Controle (por exemplo, “Clientes de Alto Valor”)
Critérios do segmento	Descrição das condições do filtro
Tamanho esperado	Número aproximado de usuários que você espera
Tamanho real	Tamanho do segmento como mostrado no Painel de Controle, ou “erro” se falhar
Tags ou eventos	Nomes de Tag e evento usados no segmento
Mensagem de erro	Mensagem exata se a criação ou compilação do segmento falhou
Caso de uso	O que você está tentando segmentar (por exemplo, oferta VIP, reativação)

Exemplo de prompt

O segmento não corresponde aos usuários esperados.

• Segmento: “High-Value Customers”
• Filtro: Usuários com “Total de Compras” maior que $500 nos últimos 90 dias
• Esperado: Cerca de 1.000 usuários
• Real: 0 usuários
• Tags usadas: “Total Purchases” (deve ser do tipo PRICE)
• Erro: O filtro compila, mas não retorna correspondências
• Caso de uso: Segmentar clientes VIP para uma oferta exclusiva

Problemas de integração e SDK

Use quando: O registro, tags, eventos ou recebimento de push falham em seu aplicativo.

Inclua estes detalhes em seu prompt para a ManyMoney AI:

Incluir no prompt	Exemplo ou formato
Plataforma	iOS, Android, Web, React Native ou Flutter
Versão do SDK	Número da versão
Framework	Swift, Objective-C, Kotlin, Java, JavaScript, etc.
Problema	Problema específico
O que funciona	Etapas que funcionam
O que falha	Etapas que falham
Logs de erro	Texto completo do erro
Trecho de código	Código relevante, se útil
Testado em	Dispositivo, emulador ou produção

Exemplo de prompt

Problema de integração do SDK no iOS.

• Plataforma: iOS 16+
• Versão do SDK: Pushwoosh 6.5.2
• Framework: Swift
• Problema: O dispositivo se registra, mas as tags não são salvas
• Funciona: Registro do token de push, recebimento de notificações
• Falha: As chamadas sendTags() parecem ser ignoradas
• Logs de erro: Nenhum, mas as tags não aparecem no Painel de Controle
• Código: pushwoosh.sendTags(["userId": "12345", "premium": true])
• Testado em: Simulador do iPhone 14 Pro e dispositivo físico

Análises e relatórios

Use quando: Você precisa entender uma métrica ou um relatório.

Inclua estes detalhes em seu prompt para a ManyMoney AI:

Incluir no prompt	Exemplo ou formato
Métrica ou relatório	Nome da métrica ou relatório (por exemplo, Taxa de entrega, Saídas da Journey)
Período de tempo	Intervalo de datas (por exemplo, Últimos 7 dias, Janeiro de 2024)
Filtros	Journey, segmento ou plataforma
Valor atual	Valor ou mensagem que você vê no Painel de Controle
Esperado	O que você esperava ou “preciso entender”
Impacto na decisão	Como você usará esses dados

Desempenho e velocidade

Use quando: Uma operação está lenta ou excede o tempo limite.

Inclua estes detalhes em seu prompt para a ManyMoney AI:

Incluir no prompt	Exemplo ou formato
Operação	O que está lento (por exemplo, compilação de segmento)
Quando	Sempre, em horários de pico ou para uma ação específica
Volume	Quantos usuários ou mensagens são afetados
Tempo	Quanto tempo leva versus o que você espera
Impacto	Impacto nos negócios
Alterações recentes	Algo mudou antes do problema começar

Verificações proativas

Você pode pedir à ManyMoney AI uma auditoria proativa. Exemplos de prompts que você pode usar:

• Journey: “Audite a configuração da minha journey em busca de possíveis problemas. Journey: nome ou UUID. Foco: entrega, desempenho, experiência do usuário ou todos.”
• E-mail: “Verifique minha configuração de e-mail em busca de problemas de entregabilidade. Aplicação: código da aplicação. Eu envio de: seu endereço de remetente, por exemplo, noreply@mystore.com. Ultimamente: por exemplo, bounces nas últimas 2 semanas, ou sem problemas.”
• Campanha: “Analise o desempenho da campanha e sugira melhorias. Journey ou campanha: nome ou UUID. Métricas atuais: o que você vê. Metas: o que você quer alcançar.”