Envie Imagens, Vídeos, PDFs, e outros conteúdos de mídia com a API Twilio para WhatsApp

November 06, 2020
Escrito por
Revisado por

whatsapp-launch
  • Agora você pode enviar arquivos de imagem, vídeo, texto e PDF com até 5mb de tamanho pelo WhatsApp.
  • Enviar uma mensagem de mídia pelo WhatsApp é semelhante a enviar um MMS - tudo o que você precisa fazer é incluir o parâmetro MediaUrl em suas solicitações de API.
  • Atualmente, o conteúdo de mídia é suportado apenas em mensagens de sessão. Se a sessão do WhatsApp com um usuário expirar, você deverá aguardar que uma mensagem de entrada crie uma nova sessão antes de poder enviar uma mensagem de mídia.

Temos o prazer de anunciar que agora você pode enviar e receber não apenas imagens e vídeos, mas também PDFs, arquivos de texto e arquivos de áudio usando a API do Twilio para WhatsApp. Na Twilio, nossa missão é permitir que desenvolvedores e empresas se envolvam efetivamente com seus clientes nos canais de mensagens de sua preferência, e isso significa poder usá-los para conversas contextuais ricas. Seus clientes querem cada vez mais se comunicar com você da mesma forma que fazem com seus amigos, familiares e colegas de trabalho, e a capacidade de trocar mídia como arquivos de imagem, áudio, vídeo e pdf é fundamental para isso.

Se você já usou nossa API MMS antes, o envio de uma mensagem de mídia pelo WhatsApp parecerá muito familiar para você. É muito semelhante a enviar um MMS - tudo que você precisa fazer é incluir o parâmetro MediaUrl em sua solicitação de API para enviar uma mensagem do WhatsApp, conforme mostrado abaixo:

curl -X POST https://api.twilio.com/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Messages.json \
   --data-urlencode "To=whatsapp:+13105555555" \
   --data-urlencode "From=whatsapp:+12125551234" \
   --data-urlencode "Body=Thanks for contacting me on WhatsApp! Here is a picture of an owl." \
   --data-urlencode "MediaUrl=https://demo.twilio.com/owl.png" \
   -u "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_auth_token"

O suporte de mídia no WhatsApp pode desbloquear uma variedade de casos de uso. Por exemplo, as companhias aéreas e os cinemas agora podem enviar diretamente aos seus clientes cartões de embarque e ingressos como PDFs, em vez de enviar um link para baixar o arquivo. As equipes de suporte ao cliente podem pedir aos clientes que enviem uma foto ou um vídeo curto de seu problema, em vez de exigir que eles o expliquem em detalhes onerosos. As empresas de comércio eletrônico podem enviar uma foto quando os pacotes forem entregues para confirmar a entrega.

No entanto, existem algumas diferenças entre as mensagens de mídia MMS e WhatsApp. Você só pode enviar mensagens de mídia para usuários do WhatsApp se tiver uma 'sessão' de mensagens ativa com eles. As sessões de mensagens são criadas quando um usuário responde a um modelo de mensagem que você envia ou inicia uma conversa enviando uma mensagem para seu número no WhatsApp e permanece ativo por 24 horas após a última mensagem enviada. As mensagens de mídia do WhatsApp também não são compatíveis com alguns tipos de arquivo que o MMS oferece. Você pode ler mais sobre o suporte a tipos de arquivo nas FAQs.

Estamos ansiosos para continuar aprimorando a API do Twilio para WhatsApp e mal podemos esperar para ver o que você vai construir!

Comece a enviar mensagens de mídia com a API Twilio para WhatsApp

Esse post foi traduzido do original por Vinicius Miguel. Qualquer dúvida saiba que estou disponível por e-mail em vmiguel [at] twilio.com e Github em vmiguelsilva.