Registre sua empresa no Apple Messages

Conecte sua conta Apple Messages for Business a um espaço de trabalho Bird e envie seu serviço para revisão. Para planejamento do atendimento, treinamento da equipe e preparação do lançamento, comece pela integração completa.

A Apple é responsável pela aprovação da conta e pela identidade empresarial voltada ao cliente. Sua equipe é responsável pelo design do serviço e pela equipe de atendimento. A Bird revisa o envio e coordena a conexão com o provedor. Criar um registro de empresa Bird não o aprova para envio de mensagens.

Prepare suas contas e seu serviço

Antes de registrar, reúna:

• Uma Apple Account corporativa e acesso à sua organização no Apple Business Register.
• Um espaço de trabalho Bird e permissão para gerenciar empresas Apple. Peça ao administrador do seu espaço de trabalho para convidar as pessoas que vão operar o canal.
• Nome da marca, contato técnico, horário de atendimento, idiomas e tempo de resposta esperado.
• As tarefas de cliente que você vai atender, os pontos de entrada que pretende usar e o caminho até uma pessoa quando uma tarefa não puder ser concluída.
• Testadores com dispositivos Apple e as Apple Accounts usadas nesses dispositivos.

Comece com uma tarefa que sua equipe consiga concluir hoje, como responder a perguntas sobre produtos e agendar uma visita à loja. Registre o que acontece quando a solicitação foge do escopo ou chega fora do horário com equipe disponível.

Conecte a conta Apple

Siga as instruções de registro da Apple para criar uma conta de teste e selecione Bird como seu provedor de serviço de mensagens. Use uma configuração avançada de endpoint apenas quando Bird fornecer os detalhes de conexão necessários.

Adicione a Apple Account de cada usuário de teste como testador e envie as alterações. Até que a Apple aprove o negócio, apenas esses usuários de teste podem enviar mensagens para ele, então adicione todos que vão construir, ensaiar e gravar a demonstração do serviço. Na configuração de provedor da Apple, use Test your Messaging Service Provider connection e depois Connect quando disponível. Conclua o fluxo de vinculação no Bird espaço de trabalho pretendido.

Em Apple Messages > Businesses, abra o registro conectado. Se Bird solicitar que você crie o registro, insira o Apple Business ID do Apple Business Register e o Brand name, e selecione Create business. Não crie um segundo registro para uma conta que já está vinculada.

Confirme que a aba Approval mostra o Apple Business ID esperado. Na aba Settings, em Channel settings, defina Brand name e Default locale e clique em Save changes. Salvar essas configurações não substitui a revisão de conta comercial da Apple.

Veja a captura de tela em tamanho completo.

Envie seu serviço para revisão

Abra a aba Approval do negócio. Approval requirements fornece os documentos e controles de upload para:

Antes de gravar, conecte seu negócio e adicione seus usuários de teste no Apple Business Register. Enquanto o negócio estiver em Testing, seus usuários de teste podem enviar mensagens para ele, então você pode construir a experiência e gravar a demonstração no iPhone de um usuário de teste antes de enviar. O lançamento público ainda requer aprovação.

Use Prepare sua demonstração para a Revisão de Experiência para planejar a gravação no iPhone, ensaiar as jornadas dos clientes e revisar as evidências. Baixe os formulários da página e preencha-os. Faça o upload dos dois PDFs e da demonstração em MP4. Use informações fictícias de clientes nos exemplos da revisão. Siga os limites de formato e upload mostrados nos controles.

Envie os requisitos preenchidos. O topo da página do negócio mostra um status, o que ele permite e qualquer feedback de revisão. Submission history na aba Approval retém as evidências e o resultado da revisão de cada tentativa. A equipe Bird registra as decisões da Apple, então não há ação do cliente que mude um negócio diretamente para Live.

Quando a Apple aprova um negócio, ao abri-lo você é direcionado à aba Settings. Antes da aprovação, ele abre na aba Approval.

Envie evidências pela API

Use a região da API que hospeda seu espaço de trabalho e uma credencial com amb_management:write para uploads e envios, além de amb_management:read para inspecionar o resultado. Envie X-Workspace-Id para esse espaço de trabalho. Atribua a cada POST um Idempotency-Key e reutilize essa chave se você tentar novamente a mesma requisição.

1. Crie um rascunho com POST /v1/amb/business-accounts. Informe name e seu apple_business_id. Salve o id da conta retornado; fornecer o UUID da Apple não envia a conta para revisão.
2. Faça upload do PDF de avaliação de prontidão, do PDF de caso de uso e do MP4 de demonstração separadamente com POST /v1/amb/business-account-attachments. Cada requisição é multipart form data com um campo file. Salve cada id de anexo retornado. Os arquivos de evidência devem ser distintos e enviados para o mesmo espaço de trabalho.
3. Envie com POST /v1/amb/business-accounts/{business_account_id}/submissions. Defina readiness_attachment_id, use_cases_attachment_id e video_attachment_id com os IDs de upload correspondentes. O envio confirma as evidências e congela o nome da empresa selecionado e o UUID da Apple para revisão. Uma resposta bem-sucedida registra a tentativa de revisão; ela não concede aprovação.
4. Leia GET /v1/amb/business-accounts/{business_account_id} para account_review_status e status operacional. O painel combina tudo em um único status. Um status de disconnected, suspended ou active aparece como Disconnected, Suspended ou Live, independentemente do estado da revisão. Caso contrário, sem account_review_status é Testing, pending é In review e rejected é Rejected. Inspecione GET /v1/amb/business-accounts/{business_account_id}/submissions para feedback da revisão e a evidência retida. Após uma rejeição, faça upload da evidência corrigida e crie uma nova submissão. Tentativas anteriores permanecem no histórico.

Use o dashboard ou HTTP API para fazer upload de arquivos. O CLI também suporta bird amb business-accounts attachments upload --file readiness.pdf, e o stdio local MCP fornece amb_business_accounts_attachments_upload. SDKs e MCP hospedados criam envios usando os IDs de anexo retornados; eles não fazem upload de arquivos locais. Um agente hospedado precisa desses IDs antes de poder enviar.

Continue para o quickstart de resposta quando a conta estiver ativa e um cliente tiver aberto uma conversa.

Prepare-se para o lançamento

Após a Revisão de Experiência, conclua a configuração da conta comercial e a revisão de ativos da Apple usando as instruções atuais no Apple Business Register. Prepare os ativos de marca, horários de resposta e localizações da empresa nesse painel.

Antes de tornar os pontos de entrada públicos:

1. Conclua o início rápido de primeira conversa usando a empresa destinada ao lançamento.
2. Peça a um operador que pratique atribuição, etiquetas e respostas, incluindo uma solicitação que ele não consiga resolver.
3. Teste cada mensagem nativa em um dispositivo autorizado. Confirme o resultado da reserva ou do pedido externo separadamente do resultado da mensagem.
4. Verifique os horários de atendimento e as expectativas voltadas ao cliente. Identifique a pessoa responsável por monitorar novas conversas e falhas.
5. Ative seus pontos de entrada aprovados e inspecione as primeiras conversas recebidas e as métricas do canal.

Resolva problemas de configuração

Se o controle de conexão da Apple estiver indisponível, confirme que a conta e os testadores foram enviados. Se a vinculação falhar, verifique o espaço de trabalho Bird e o Apple Business ID antes de tentar novamente. Se a ação Bird estiver ausente ou desativada, peça ao administrador que verifique suas permissões de gerenciamento de empresas.

Para um atraso na revisão, leia o status no topo da página do negócio, o Submission history e o e-mail da conta para solicitações de Bird ou da Apple. Para um negócio aprovado que não consegue responder, siga a solução de problemas do canal.