Descrizione
Connettore enterprise per Twilio — la piattaforma comunicazioni programmabili #1 al mondo (Software API leader fondato 2008, $20B valuation pre-IPO con 250k+ developer customer, copre il 90% degli SMS+voice+WhatsApp use case enterprise di tier-1 brand) via REST API ufficiale. Tre operazioni atomiche coprono il main feature set: sendSms (invia SMS classico su qualsiasi rete mobile mondiale, body fino a 1600 char con automatic segmentation in N parti se eccede 160 char standard GSM o 70 char Unicode, supporta concatenated SMS UDH per delivery come singolo messaggio sul dispositivo cliente), sendWhatsapp (invia messaggi WhatsApp Business via il sandbox Twilio o numero approvato in WhatsApp Business Manager, con prefix sintattico "whatsapp:+393331234567" che distingue il channel — supporta messaggi text + media attachment + template approvati), getMessage (lookup status delivery + error code di un messaggio precedentemente inviato by SID). Auth via Account SID (formato AC + 32 hex chars univoco del Twilio account) + Auth Token (secret rotabile per security incident response) entrambi stored nel vault integration FlowForge. Validation pre-call enterprise: accountSid validato sintatticamente (AC + 32 hex per anti-typo che produrrebbe 404 dopo network roundtrip), numeri E.164 validation rigorosa (+393331234567 format obbligatorio + country code detection per auto-prepend del "+" se mancante in input italiano "3331234567"). Pipeline anti-vulnerability standard del connector enterprise FlowForge: SSRF-safe gateway HTTP per evitare chiamate a endpoint privati, body form-urlencoded come Twilio API richiede (NON JSON come la maggior parte degli altri provider — pattern unico che molti developer sbagliano), circuit-breaker dedicato per evitare hammer durante upstream outage Twilio (rare ma succedono), retry exponential backoff con jitter su 5xx transient e 429 rate-limit. Rate limit Twilio: 1 SMS/sec per numero sender (capacity expandable a 10 SMS/sec con request approval in Twilio Console — pattern critical per high-volume marketing campaign), WhatsApp 80 msg/sec per numero, voice unlimited concurrent. Errori semantici espliciti: 30003 (delivery failed unreachable destination), 30004 (filtered da carrier per spam), 30005 (numero invalid), 21408 (numero blocked dal customer) — il nodo li parsa e restituisce semantic error code al workflow downstream per gestione differenziata. Output: { messageSid? (univoco Twilio per tracking), status? (queued|sending|sent|delivered|failed), errorCode? (semantic), to, from, segmentsCount?, billingCost? }. Use case: notifica OTP/2FA al cliente per login multi-factor sicurezza accounts SaaS; alert critici al team di SRE/ops via SMS per incident production (pattern PagerDuty-lite); conferma ordine/appuntamento tramite SMS subito post-checkout con tracking number e link customer area; promemoria scadenza fattura via WhatsApp 7gg pre-scadenza per ridurre DSO (Days Sales Outstanding) e improve cash flow; recupero crediti automatic multi-step con escalation (1° SMS gentile 30gg + 2° WhatsApp formale 60gg + 3° voicemail automatic 90gg → handoff legale); follow-up lead commerciale multicanale (email + SMS + WhatsApp coordinati per maximize touch reach).
