# WhatsApp-afbeeldingsberichten

Een afbeeldingsbericht bevat een publieke URL die WhatsApp op het moment van verzenden ophaalt, met een optioneel bijschrift eronder.

## Een afbeelding versturen

Stel `image.url` in:

**TypeScript**

```typescript
const msg = await bird.whatsapp.send({
  to: "+16505551234",
  from: "+13124495648",
  image: { url: "https://cdn.example.com/receipt.png" },
});
console.log(msg.id, msg.status);
```

Examples: [TypeScript](/nl-nl/documentatie/guides/whatsapp/message-types/images.ts.md) · [Python](/nl-nl/documentatie/guides/whatsapp/message-types/images.py.md) · [Go](/nl-nl/documentatie/guides/whatsapp/message-types/images.go.md) · [PHP](/nl-nl/documentatie/guides/whatsapp/message-types/images.php.md) · [CLI](/nl-nl/documentatie/guides/whatsapp/message-types/images.cli.md) · [MCP](/nl-nl/documentatie/guides/whatsapp/message-types/images.mcp.md) · [cURL](/nl-nl/documentatie/guides/whatsapp/message-types/images.curl.md)

De volledige structuur voegt een optionele `caption` toe:

```json
{
  "to": "+16505551234",
  "from": "+13124495648",
  "image": {
    "url": "https://cdn.example.com/receipts/a1b2c3.png",
    "caption": "Your receipt for order A1B2C3"
  }
}
```

`image` heeft geen `filename`-veld. `from` is verplicht bij elk servicebericht: een nummer dat je werkruimte bezit, niet een door Bird beheerd nummer.

## Limieten

| Veld            | Grens                                                       | Gecontroleerd door                   |
| --------------- | ----------------------------------------------------------- | ------------------------------------ |
| Bestandsgrootte | 5 MB                                                        | alleen WhatsApp, bij ophalen (async) |
| Bestandstype    | JPEG of PNG                                                 | alleen WhatsApp, bij ophalen (async) |
| `caption`       | maximaal 1024 tekens                                        | Bird, bij acceptatie (`422`)         |
| `url`           | absoluut, `https`, heeft een host, geen ongecodeerde spatie | Bird, bij acceptatie (`422`)         |

Bird controleert de vorm van de URL en de lengte van het bijschrift voordat er iets in de wachtrij wordt geplaatst. Het controleert niet de werkelijke bestandsgrootte of het type; dat kan alleen de eigen fetch van WhatsApp op het moment van verzenden. Zie de hub-pagina [media versturen via URL](/docs/guides/whatsapp/message-types#sending-media-by-url) voor wat die vormcontrole omvat, en [wanneer media mislukt](/docs/guides/whatsapp/message-types#when-media-fails) voor wat er gebeurt als de fetch van WhatsApp het bestand afwijst.

## Een inkomende afbeelding lezen

Een inkomende afbeelding bevat hetzelfde `image`-object, plus een `id` en `mime_type` die Bird heeft bepaald door het bestand op te halen. Beide ontbreken bij het teruglezen van een uitgaand bericht, omdat Bird het verzonden bestand nooit zelf heeft opgehaald. Zie [WhatsApp-afbeeldingen ontvangen](/docs/guides/whatsapp/receiving-whatsapp/images) voor het volledige inkomende bericht, de `whatsapp.received`-payload en waar je op moet letten.

## Limieten en foutscenario's

- **Het klantenservicevenster moet open zijn.** Afbeeldingen zijn serviceberichten en kunnen alleen binnen een open venster worden bezorgd; zie de hub-pagina [klantenservicevenster](/docs/guides/whatsapp/message-types#the-customer-service-window).
- **Bird wijst `http` af; WhatsApp zelf zou het wel ophalen.** Dat onderscheid en de rest van de URL-vormcontrole staan op de hub-pagina [media versturen via URL](/docs/guides/whatsapp/message-types#sending-media-by-url).
- **Een te groot bestand, een verkeerd MIME-type of een onbereikbare URL mislukken allemaal op dezelfde manier, en pas nadat er kosten in rekening zijn gebracht.** Zie de hub-pagina [wanneer media mislukt](/docs/guides/whatsapp/message-types#when-media-fails) voor `media_rejected` en het feit dat er ook bij een mislukte verzending kosten in rekening worden gebracht.
- **WhatsApp cachet een opgehaalde URL ongeveer 10 minuten.** Als je dezelfde URL binnen dat venster opnieuw verstuurt, wordt het eerste ophaalresultaat hergebruikt in plaats van opnieuw opgehaald; varieer de URL (bijvoorbeeld met een queryparameter) om een nieuw ophaalverzoek te forceren.

## Vervolgstappen

- [WhatsApp-serviceberichten](/docs/guides/whatsapp/message-types): het klantenservicevenster en het model dat alle serviceberichten delen
- [Video](/docs/guides/whatsapp/message-types/video): dezelfde structuur voor een videoclip
- [Documenten](/docs/guides/whatsapp/message-types/documents): voor een PDF, spreadsheet of ander bestand
- [WhatsApp-berichten versturen](/docs/guides/whatsapp/sending-whatsapp): de request-envelop, het `202`-model en veilig opnieuw proberen

## Related resources

- [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video)
- [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer)
- [WhatsApp message builder](/tools/whatsapp-message-builder) (tool)
- [WhatsApp](/products/whatsapp) (product)

[Get an implementation brief](/learn/workspace?topic=whatsapp)