# Envie imagens e arquivos no Apple Messages

Use um template de **Image** ou **Document** para enviar imagens de produtos, instruções ou um recibo em uma conversa aberta com o cliente. Bird busca o arquivo de origem e o prepara para a Apple durante o processamento da mensagem.

## Prepare um arquivo acessível

Hospede o arquivo desejado em uma URL HTTPS pública que possa ser acessada sem cookies de navegador ou login. Use um arquivo específico para a finalidade que seja seguro expor nessa URL. Uma página de pré-visualização de drive privado não é uma URL direta de arquivo.

A [referência de envio de mensagem](/docs/api/reference/create-amb-message) define as restrições de mídia:

| Uso                                     | Requisito                                                                                     |
| --------------------------------------- | --------------------------------------------------------------------------------------------- |
| Anexo de saída                          | Cada arquivo deve ter menos de 100 MB. Forneça o nome de arquivo e o tipo de mídia corretos.  |
| Interação nativa ou imagem de rich link | PNG, até 200 kB por imagem; imagens interativas totalizam no máximo 5 MB.                     |
| Ícone publicado do app iMessage         | PNG menor que 15 kB. Consulte [experiências de app](/docs/guides/apple-messages/custom-apps). |

Mantenha a URL disponível enquanto o processamento é concluído. Uma URL assinada que expira cedo demais pode causar uma falha depois que a mensagem foi aceita. Teste a URL sem um navegador autenticado e confirme que ela retorna o arquivo real em vez de uma página HTML.

## Configure o template

1. Abra [**Templates**](https://bird.com/dashboard/w/apple-messages/templates) e escolha **New template > Image** ou **Document**.
2. Em **Content**, dê ao rascunho um **Template name** e insira uma **Message** útil que explique o anexo.
3. Em **Apple delivery**, defina **Attachment URL**, **File name** e **Media type**. Por exemplo, um PDF usa um nome de arquivo `.pdf` e `application/pdf`.
4. Selecione o negócio em **Personalization** e salve o rascunho.
5. [Prepare e revise a mensagem](/docs/guides/apple-messages/templates#send-the-reviewed-template), verificando o cliente e o arquivo reais antes de enviar.

A arte de pré-visualização incluída no pacote não é uma fonte de anexo para um envio real. Forneça a URL desejada explicitamente.

## Verifique o resultado

Inspecione a mensagem enviada e os eventos, depois abra o anexo em um dispositivo de teste Apple autorizado. Verifique a legibilidade, o nome do arquivo e se o conteúdo faz sentido sem o site ao redor.

Se a mensagem falhar após a aceitação, inspecione o erro antes de alterar o template. Causas comuns incluem uma URL inacessível, um tipo de mídia inesperado, um arquivo acima do limite de tamanho ou dados PNG inválidos. Alterar a extensão de um arquivo não converte seu formato.

Anexos recebidos podem aparecer pelo nome na transcrição da conversa. A transcrição não oferece atualmente uma ação de download autenticado para esses arquivos. As operações de recuperação de anexos e mídia não fazem parte da API pública. Se o seu serviço precisa baixar arquivos recebidos, confirme um fluxo de recuperação disponível com Bird antes de depender dele.