Troubleshooting Whatsapp

SELECT id, from_name, contact_number, chat_name, body_text, date, created_at
FROM command_center_inbox
WHERE type = 'whatsapp'
  AND contact_number = '{PHONE}'
ORDER BY created_at DESC LIMIT 10;

Se presente: il messaggio c'e' ma non e' stato processato (l'utente non ha cliccato "Done").

4. E' gia' in production?

SELECT i.interaction_id, i.interaction_date, i.summary, ch.chat_name
FROM interactions i
LEFT JOIN chats ch ON i.chat_id = ch.id
WHERE i.interaction_type = 'whatsapp'
  AND i.external_interaction_id = '{MESSAGE_UID}';

5. TimelinesAI e' connesso?

• Verificare dashboard TimelinesAI: https://timelines.ai
• Controllare che il dispositivo WhatsApp sia ancora collegato
• Se disconnesso: ricollegare da dashboard TimelinesAI

Impossibile inviare messaggi (Baileys)

Checklist

1. Stato connessione Baileys

curl -s https://command-center-backend-production.up.railway.app/whatsapp/status

Risposte e azioni:

2. Se disconnected o qr_ready:

• Aprire: https://command-center-backend-production.up.railway.app/whatsapp/qr-image
• Scansionare con WhatsApp → Impostazioni → Dispositivi collegati
• Il QR scade in ~60 secondi, ricaricare se necessario

3. Se errore "Stream Errored (conflict)":

• Causa: due istanze Baileys con la stessa sessione (es. locale + Railway)
• Soluzione: usare UNA sola istanza alla volta
• Se necessario, fare logout e re-scan:

curl -X POST https://command-center-backend-production.up.railway.app/whatsapp/logout

4. Formato numero errato:

• Baileys NON vuole il + ne' lo zero iniziale
• Corretto: 393456789012
• Errato: +393456789012, 03456789012

Messaggi inviati non appaiono in Supabase

Causa

Il flusso di salvataggio dei messaggi inviati via Baileys dipende dal multi-device sync:

Baileys invia → WhatsApp sync → TimelinesAI riceve → webhook → command_center_inbox

Checklist

1. TimelinesAI e' attivo?

• Verificare dashboard TimelinesAI
• Se disconnesso, i messaggi inviati non vengono catturati

2. Baileys E TimelinesAI sono entrambi connessi?

• Servono entrambi sullo stesso account WhatsApp
• Baileys come dispositivo collegato
• TimelinesAI come altro dispositivo collegato

3. Multi-device sync funziona?

• Inviare un messaggio di test da Baileys
• Verificare che appaia su TimelinesAI entro qualche secondo
• Se non appare: problema di sync WhatsApp multi-device

Messaggi duplicati

Diagnosi

-- Duplicati in production
SELECT external_interaction_id, COUNT(*) as count
FROM interactions
WHERE interaction_type = 'whatsapp'
  AND external_interaction_id IS NOT NULL
GROUP BY external_interaction_id
HAVING COUNT(*) > 1;

Causa probabile

• In staging: non dovrebbe succedere (webhook singolo per messaggio)
• In production: messaggio processato ("Done") piu' volte manualmente

Contatto non collegato al messaggio WhatsApp

Diagnosi

-- 1. Il contatto ha questo numero?
SELECT * FROM contact_mobiles WHERE mobile = '{PHONE}';

-- 2. Esiste il collegamento chat?
SELECT * FROM contact_chats cc
JOIN chats ch ON cc.chat_id = ch.id
WHERE cc.contact_id = '{CONTACT_UUID}';

Causa probabile

• Se messaggio in staging: il collegamento avviene solo dopo processing ("Done")
• Se in production senza contact_chat: bug nel processing

Gruppo non mostra tutti i partecipanti

Diagnosi

-- Quanti partecipanti registrati?
SELECT COUNT(*) FROM contact_chats WHERE chat_id = '{CHAT_UUID}';

-- Chi c'e'?
SELECT c.first_name, c.last_name, cm.mobile
FROM contact_chats cc
JOIN contacts c ON cc.contact_id = c.contact_id
LEFT JOIN contact_mobiles cm ON c.contact_id = cm.contact_id
WHERE cc.chat_id = '{CHAT_UUID}';

Causa probabile

• Nuovi partecipanti non vengono rilevati automaticamente
• Serve processing manuale via frontend

Lifecycle degli stati messaggio

STATO 1: SOLO IN WHATSAPP
- Non ancora ricevuto da TimelinesAI
- Nessun record nel CRM
         |
    (webhook TimelinesAI)
         v
STATO 2: STAGING (command_center_inbox)
- Ricevuto via webhook
- Visibile nel tab WhatsApp del CRM
- In attesa di processing utente
         |
    (user "Done")
         v
STATO 3: PRODUCTION (chats + interactions)
- Processato e archiviato
- Collegato a contatti via contact_chats
- Record interaction creato
- Rimosso da command_center_inbox

Come determinare lo stato

-- E' in staging?
SELECT EXISTS(
  SELECT 1 FROM command_center_inbox
  WHERE type = 'whatsapp' AND message_uid = '{MESSAGE_UID}'
) as in_staging;

-- E' in production?
SELECT EXISTS(
  SELECT 1 FROM interactions
  WHERE interaction_type = 'whatsapp' AND external_interaction_id = '{MESSAGE_UID}'
) as in_production;

Tabella riassuntiva stati

Servizi coinvolti

Riferimenti

• Backend invio: command-center-backend (Railway)
• Backend ricezione: crm-agent-service (Railway)
• Handler webhook: crm-agent-service/app/main.py
• Documentazione: /home/user/crm-frontend/docs/WHATSAPP_SENDING.md
• Skill principale: skills/whatsapp.md
• Baileys API base: https://command-center-backend-production.up.railway.app
• QR code: https://command-center-backend-production.up.railway.app/whatsapp/qr-image
• TimelinesAI dashboard: https://timelines.ai