# Solução de problemas com a ManyMoney AI

Este guia explica como solucionar problemas com a [ManyMoney AI](/pt/product/pushwoosh-ai/ai-assistant/). Quando você fornece informações estruturadas em seus prompts, a ManyMoney AI pode diagnosticar mais rápido e sugerir correções mais precisas.

<Aside type="tip">
Se precisar de suporte humano, você pode [enviar um ticket](https://help.pushwoosh.com/hc/en-us/requests/new) para o Suporte da Pushwoosh.
</Aside>

## O que a ManyMoney AI pode inspecionar

A ManyMoney AI usa as APIs da Pushwoosh para inspecionar:

| Categoria <div style="width:160px"></div> | O que inspeciona <div style="width:320px"></div> |
| --- | --- |
| 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](/pt/product/audience-data-and-segmentation/segmentation/) |
| 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 <div style="width:280px"></div> | Não fazer <div style="width:280px"></div> |
| --- | --- |
| **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](/pt/developer/api-reference/api-identifiers/#journey-id) 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. |

<Aside type="tip" title="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.
</Aside>

## 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](/pt/developer/api-reference/api-identifiers/).



### 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 <div style="width:180px"></div> | Exemplo ou formato <div style="width:200px"></div> |
| --- | --- |
| Plataforma | iOS, Android ou Web |
| Journey | [ID da Journey](/pt/developer/api-reference/api-identifiers/#journey-id) 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](/pt/developer/api-reference/api-identifiers/#hardware-id) (HWID) se estiver testando em um dispositivo específico |
| Esperado | O que deveria acontecer |
| Real | O que acontece em vez disso |

<Aside type="tip" title="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
</Aside>

### 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 <div style="width:180px"></div> | Exemplo ou formato <div style="width:200px"></div> |
| --- | --- |
| Campanha ou journey | Nome ou [UUID](/pt/developer/api-reference/api-identifiers/#journey-id) |
| Modelo de e-mail | Nome ou [código de conteúdo do e-mail](/pt/developer/api-reference/api-identifiers/#email-content-code) |
| 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](/pt/product/audience-data-and-segmentation/segmentation/) 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 |

<Aside type="tip" title="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
</Aside>

### 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 <div style="width:180px"></div> | Exemplo ou formato <div style="width:200px"></div> |
| --- | --- |
| Nome da journey, URL ou UUID | URL completo ou [ID da Journey](/pt/developer/api-reference/api-identifiers/#journey-id) |
| Status | Rascunho, Inativa, Ativa, Pausada ou Arquivada |
| Tipo de entrada | [Baseada em gatilho](/pt/product/customer-journey/journey-elements/entry-elements/trigger-based-entry/), [baseada em público](/pt/product/customer-journey/journey-elements/entry-elements/audience-based-entry/) ou [baseada em API](/pt/product/customer-journey/journey-elements/entry-elements/api-based-entry/) |
| Evento ou segmento de entrada | [Nome do evento](/pt/developer/api-reference/api-identifiers/#event-name) ou [Nome do segmento](/pt/developer/api-reference/api-identifiers/#segment-filter-name) |
| 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 |

<Aside type="tip" title="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
</Aside>

### 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 <div style="width:180px"></div> | Exemplo ou formato <div style="width:200px"></div> |
| --- | --- |
| 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](/pt/developer/api-reference/api-identifiers/#tag) e [evento](/pt/developer/api-reference/api-identifiers/#event-name) 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) |

<Aside type="tip" title="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
</Aside>

### 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 <div style="width:180px"></div> | Exemplo ou formato <div style="width:200px"></div> |
| --- | --- |
| 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 |

<Aside type="tip" title="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
</Aside>

### 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 <div style="width:180px"></div> | Exemplo ou formato <div style="width:200px"></div> |
| --- | --- |
| 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](/pt/product/customer-journey/pushwoosh-journey-overview/), [segmento](/pt/product/audience-data-and-segmentation/segmentation/) 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 <div style="width:180px"></div> | Exemplo ou formato <div style="width:200px"></div> |
| --- | --- |
| 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](/pt/developer/api-reference/api-identifiers/#application-code). 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`."