Send WhatsApp message

Wysylka wiadomosci WhatsApp z idempotency key i kontrola statusu conversation.

Kiedy tego uzyc

Uzyj tego przepisu, gdy chcesz: Wyslac outbound WhatsApp message do istniejacej konwersacji bez ryzyka duplikacji po retry.

Endpoint referencyjny: POST /inbox/conversations/{id}/messages.

Implementacja

Node.js

import { DarhimLabs } from "@darhimlabs/node";

const client = new DarhimLabs(process.env.DARHIMLABS_API_KEY!);
await client.inbox.conversations.sendMessage(conversationId, { content: 'Czesc! Czym moge pomoc?', channel: 'whatsapp' }, { idempotencyKey });

Python

import os
from darhimlabs import DarhimLabs

client = DarhimLabs(api_key=os.environ["DARHIMLABS_API_KEY"])
client.inbox.conversations.send_message(conversation_id, content='Czesc! Czym moge pomoc?', channel='whatsapp', idempotency_key=idempotency_key)

PHP

<?php

$client = new DarhimLabs\Client(["api_key" => $_ENV["DARHIMLABS_API_KEY"]]);
$client->inbox->conversations->sendMessage($conversationId, ['content' => 'Czesc! Czym moge pomoc?', 'channel' => 'whatsapp'], ['idempotency_key' => $idempotencyKey]);

Ruby

client = DarhimLabs::Client.new(api_key: ENV["DARHIMLABS_API_KEY"])
client.inbox.conversations.send_message(conversation_id, content: 'Czesc! Czym moge pomoc?', channel: 'whatsapp', idempotency_key: idempotency_key)

Test it

Wykonaj request w sandboxie z kluczem dl_test_....
Sprawdz X-Request-ID w odpowiedzi.
Dla webhookow uzyj Webhook Playground, zeby zobaczyc payload live.

Common pitfalls

Nie tworz nowej conversation dla kazdej odpowiedzi. Najpierw wyszukaj lub zapisz conversation id.
Loguj request_id i event_id, zeby support mogl odtworzyc problem.
Dla mutacji dodawaj Idempotency-Key, szczegolnie jesli request moze byc retryowany.

Production checklist

Dodaj retry z exponential backoff i jitterem.
Ogranicz scopes API key do minimalnego zestawu.
Monitoruj rate limit headers i latency P95.
Przetestuj bledy 401, 409, 422 i 429.