Registrare la tua attività su Apple Messages

Collega il tuo account Apple Messages for Business a uno spazio di lavoro Bird e invia il servizio per la revisione. Per pianificare il servizio, formare il personale e preparare il lancio, inizia dalla configurazione iniziale completa.

Apple gestisce l'approvazione dell'account e l'identità aziendale rivolta al cliente. Il tuo team gestisce la progettazione del servizio e l'organico. Bird esamina la submission e coordina la connessione al provider. Creare un record aziendale Bird non equivale ad approvarlo per l'invio.

Preparare account e servizio

Prima di registrarti, raccogli:

• Un Apple Account aziendale e l'accesso alla tua organizzazione in Apple Business Register.
• Uno spazio di lavoro Bird e il permesso di gestire le attività Apple. Chiedi all'amministratore dello spazio di lavoro di invitare le persone che gestiranno il canale.
• Il nome del brand, il contatto tecnico, gli orari di servizio, le lingue e il tempo di risposta atteso.
• Le attività del cliente che supporterai, i punti di ingresso che intendi usare e il percorso verso una persona quando un'attività non può essere completata.
• Tester con dispositivi Apple e gli Apple Account utilizzati su quei dispositivi.

Inizia con un’attività che il team può completare già oggi, come rispondere a domande sui prodotti e organizzare una visita in negozio. Registra cosa succede quando la richiesta esula dall’ambito del servizio o arriva fuori dagli orari di presenza del personale.

Collegare l'account Apple

Segui le istruzioni di registrazione di Apple per creare un account di prova e selezionare Bird come fornitore del servizio di messaggistica. Usa una configurazione avanzata dell’endpoint solo quando Bird ti fornisce i dettagli di connessione necessari.

Aggiungi l'Apple Account di ogni utente di test come tester, quindi invia le modifiche. Finché Apple non approva il business, solo questi utenti di test possono inviargli messaggi: aggiungi quindi tutti coloro che costruiranno, proveranno e registreranno la dimostrazione del servizio. Nella configurazione del provider di Apple, usa Test your Messaging Service Provider connection e poi Connect quando disponibile. Completa il flusso di collegamento nello spazio di lavoro Bird previsto.

In Apple Messages > Businesses, apri il record collegato. Se Bird ti chiede di creare il record, inserisci l'Apple Business ID da Apple Business Register e il tuo Brand name, poi seleziona Create business. Non creare un secondo record per un account già collegato.

Verifica che la scheda Approval mostri l'Apple Business ID atteso. Nella scheda Settings, in Channel settings, imposta Brand name e Default locale, quindi seleziona Save changes. Il salvataggio di queste impostazioni non sostituisce la revisione dell'account commerciale da parte di Apple.

Visualizza lo screenshot a grandezza originale.

Inviare il servizio per la revisione

Apri la scheda Approval del business. Approval requirements fornisce i documenti e i controlli di caricamento per:

Prima di registrare, collega il tuo business e aggiungi gli utenti di test in Apple Business Register. Mentre il business è in Testing, i tuoi utenti di test possono inviargli messaggi, così puoi costruire l'esperienza e registrare la dimostrazione sull'iPhone di un utente di test prima di inviare la richiesta. Il lancio pubblico richiede comunque l'approvazione.

Usa Prepara la demo per l’Experience Review per pianificare la registrazione su iPhone, provare i percorsi dei clienti e rivedere le evidenze. Scarica i moduli dalla pagina e compilali. Carica entrambi i PDF e la dimostrazione MP4. Usa informazioni fittizie sui clienti negli esempi per la revisione. Rispetta il formato e i limiti di caricamento indicati dai comandi.

Invia i requisiti completati. La parte superiore della pagina del business mostra uno stato, ciò che consente ed eventuali feedback della revisione. Submission history nella scheda Approval conserva le prove e il risultato della revisione di ogni tentativo. Il personale Bird registra le decisioni di Apple, quindi non esiste un'azione del cliente che porti un business direttamente a Live.

Quando Apple approva un business, aprendolo si accede alla scheda Settings. Prima dell'approvazione, si apre su Approval.

Inviare le evidenze tramite la API

Usa la API nella regione che ospita il tuo spazio di lavoro e una credenziale con amb_management:write per caricamenti e invii, oltre a amb_management:read per controllare il risultato. Invia X-Workspace-Id per quello spazio di lavoro. Assegna a ogni POST un Idempotency-Key e riutilizza quella chiave se riprovi la stessa richiesta.

1. Crea una bozza con POST /v1/amb/business-accounts. Fornisci name e il tuo apple_business_id. Salva l'id dell'account restituito; fornire l'UUID di Apple non invia l'account per la revisione.
2. Carica separatamente il PDF di valutazione della preparazione, il PDF del caso d'uso e l'MP4 dimostrativo con POST /v1/amb/business-account-attachments. Ogni richiesta è multipart form data con un campo file. Salva ogni id dell'allegato restituito. I file di evidenza devono essere distinti e caricati nello stesso spazio di lavoro.
3. Invia con POST /v1/amb/business-accounts/{business_account_id}/submissions. Imposta readiness_attachment_id, use_cases_attachment_id e video_attachment_id con gli ID di caricamento corrispondenti. L'invio registra le evidenze e blocca il nome dell'attività selezionata e l'UUID di Apple per la revisione. Una risposta positiva registra il tentativo di revisione; non concede l'approvazione.
4. Leggi GET /v1/amb/business-accounts/{business_account_id} per account_review_status e status operativo. La dashboard li combina in un unico stato. Un status di disconnected, suspended o active viene mostrato come Disconnected, Suspended o Live, indipendentemente dallo stato della revisione. Altrimenti, nessun account_review_status corrisponde a Testing, pending corrisponde a In review e rejected corrisponde a Rejected. Controlla GET /v1/amb/business-accounts/{business_account_id}/submissions per il feedback della revisione e la documentazione conservata. Dopo un rifiuto, carica la documentazione corretta e crea una nuova sottomissione. I tentativi precedenti restano nella cronologia.

Usa la dashboard o HTTP API per caricare file. La CLI supporta anche bird amb business-accounts attachments upload --file readiness.pdf, e lo stdio locale MCP fornisce amb_business_accounts_attachments_upload. Gli SDK e i MCP hosted creano invii usando gli ID degli allegati restituiti; non caricano file locali. Un agente hosted ha bisogno di quegli ID da te prima di poter inviare.

Passa alla guida rapida di risposta quando l'account è attivo e un cliente ha aperto una conversazione.

Preparare il lancio

Dopo l'Experience Review, completa la configurazione dell'account commerciale e la revisione degli asset di Apple seguendo le istruzioni correnti in Apple Business Register. Prepara le risorse del brand, gli orari di risposta e le sedi aziendali in quella sezione.

Prima di rendere pubblici i punti di ingresso:

1. Completa il quickstart sulla prima conversazione usando l'azienda destinata al lancio.
2. Fai esercitare un operatore su assegnazione, etichette e risposte, includendo una richiesta che non è in grado di risolvere.
3. Testa ogni messaggio nativo su un dispositivo autorizzato. Verifica il risultato della prenotazione o dell'ordine esterno separatamente dal risultato del messaggio.
4. Controlla gli orari di servizio e le aspettative rivolte al cliente. Indica la persona responsabile del monitoraggio delle nuove conversazioni e dei malfunzionamenti.
5. Attiva i punti di ingresso approvati, quindi esamina le prime conversazioni in arrivo e le metriche del canale.

Risolvere i problemi di configurazione

Se il controllo di connessione di Apple non è disponibile, verifica che l'account e i tester siano stati inviati. Se il collegamento non riesce, controlla lo spazio di lavoro Bird e l'Apple Business ID prima di riprovare. Se l'azione Bird è mancante o disabilitata, chiedi all'amministratore di verificare i permessi di gestione delle attività.

In caso di ritardo nella revisione, leggi lo stato in cima alla pagina del business, la Submission history e l'email dell'account per eventuali richieste da Bird o Apple. Per un business approvato che non riesce a rispondere, segui la risoluzione dei problemi del canale.