Messaggi audio WhatsApp

Inviare un messaggio audio

const msg = await bird.whatsapp.send({
  to: "+16505551234",
  from: "+13124495648",
  audio: { url: "https://cdn.example.com/vm/9f2.ogg" },
});
console.log(msg.id, msg.status);

msg = client.whatsapp.send(
    to="+16505551234",
    from_="+13124495648",
    audio={"url": "https://cdn.example.com/vm/9f2.ogg"},
)
print(msg.id, msg.status)

package main

import (
	"context"
	"fmt"
	"log"
	"os"

	bird "github.com/messagebird/bird-sdk-go"
	"github.com/messagebird/bird-sdk-go/option"
)

func main() {
	client, err := bird.NewClient(option.WithAPIKey(os.Getenv("BIRD_API_KEY")))
	if err != nil {
		log.Fatal(err)
	}
	msg, err := client.Whatsapp.Send(context.Background(), bird.WhatsappSendParams{
		To:   "+16505551234",
		From: "+13124495648",
		Audio: &bird.WhatsAppAudioSend{Url: "https://cdn.example.com/vm/9f2.ogg"},
	})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(msg.Id, *msg.Status)
}

$audio = (new WhatsAppMessageSendRequestAudio())
    ->setUrl('https://cdn.example.com/vm/9f2.ogg');
$message = $bird->whatsapp->send(
    to: '+16505551234',
    from: '+13124495648',
    audio: $audio,
);
echo $message->getId(), ' ', $message->getStatus();

bird whatsapp send \
  --audio https://cdn.example.com/vm/9f2.ogg \
  --from +13124495648 \
  --to +16505551234

{
  "name": "whatsapp_send",
  "arguments": {
    "audio": {
      "url": "https://cdn.example.com/vm/9f2.ogg"
    },
    "from": "+13124495648",
    "to": "+16505551234"
  }
}

curl -X POST "https://us1.platform.bird.com/v1/whatsapp/messages" \
  -H "Authorization: Bearer $BIRD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "to": "+16505551234",
      "from": "+13124495648",
      "audio": {
        "url": "https://cdn.example.com/vm/9f2.ogg"
      }
    }'

{
  "to": "+16505551234",
  "from": "+13124495648",
  "audio": { "url": "https://cdn.example.com/voice/9f2e4a.ogg", "voice": true }
}

Limiti

Leggere un messaggio audio in entrata

Limiti e modalità di errore

• La finestra di servizio clienti deve essere aperta. L'audio è un messaggio di servizio, recapitabile solo all'interno di una finestra aperta; consulta la guida dell'hub sulla finestra di servizio clienti.
• Bird rifiuta http; WhatsApp stesso lo recupererebbe. Consulta la guida dell'hub su invio di media tramite URL per il controllo completo della forma.
• Un fetch rifiutato viene comunque addebitato. Consulta la guida dell'hub su quando un media fallisce. Il testo di rifiuto specifico dell'audio da parte di WhatsApp non è stato misurato in modo indipendente, quindi considera la mappatura come dedotta per simmetria piuttosto che confermata per singola causa.
• Il flag voice cambia il modo in cui il client del destinatario visualizza il messaggio, non ciò che Bird valida. voice: true lo visualizza come nota vocale: si scarica automaticamente, mostra un'icona microfono inline e può essere trascritto. Per ottenere questo risultato serve un file .ogg codificato con OPUS, mono; qualsiasi altro formato viene comunque inviato, ma la trascrizione fallisce lato destinatario. voice ha come valore predefinito false.
• La soglia dell'icona di riproduzione e il segnale "played" di WhatsApp non sono esposti da Bird. WhatsApp documenta un comportamento del client per le note vocali brevi e uno stato di riproduzione, ma Bird non modella nessuno dei due; non costruire un'integrazione che si aspetti di leggere l'uno o l'altro dalla API.
• WhatsApp mantiene in cache un URL recuperato per circa 10 minuti. Reinviare lo stesso URL all'interno di quella finestra restituisce il primo fetch; varia l'URL per forzarne uno nuovo.

Prossimi passi

• Messaggi di servizio WhatsApp: la finestra di servizio clienti e il modello condiviso da ogni messaggio di servizio
• Video: per un clip video anziché audio
• Sticker: un altro tipo di media senza campo didascalia
• Invio di messaggi WhatsApp: la busta della richiesta, il modello 202 e i tentativi sicuri