Bauen Sie auf der Tech Pad API.

Schnellstart

Von null bis zu einer zugestellten WhatsApp-Nachricht in vier Schritten. Alles hier funktioniert auch innerhalb der App Entwickler → Übersicht Seite, die Ihren Fortschritt verfolgt.

Authentifizierung

Die API wird mit pro-Arbeitsbereich API-Schlüsseln authentifiziert, die als Bearer-Token gesendet werden. Schlüssel werden erstellt und widerrufen von Entwickler → API-Schlüssel.

• Schlüssel beginnen mit ttp_live_ und sind auf einen Arbeitsbereich beschränkt.
• Erstellen Sie für jede Integration einen eigenen Schlüssel – jeder Schlüssel verfolgt seinen eigenen last used Zeitstempel.
• Das vollständige Geheimnis wird nur einmal bei der Erstellung angezeigt; es kann später nicht wiederhergestellt werden. Widerrufen und neu erstellen statt dessen.
• Senden Sie den Schlüssel im Authorization Header: Authorization: Bearer ttp_live_…

Eine Nachricht senden

Sendet eine genehmigte WhatsApp-Vorlagen-Nachricht an einen angemeldeten Empfänger von einer verbundenen Nummer in Ihrem Workspace.

Anfragetext

Beispielanforderung

curl -X POST 'https://v1.thetechpad.com/functions/v1/api-send' \
  -H 'Authorization: Bearer ttp_live_...' \
  -H 'Content-Type: application/json' \
  -d '{
  "phoneNumberId": "1122334455",
  "to": "15551234567",
  "template": {
    "name": "order_update",
    "language": "en",
    "parameters": ["Ava", "#4031"]
  }
}'

// JavaScript
const response = await fetch('https://v1.thetechpad.com/functions/v1/api-send', {
  method: 'POST',
  headers: { Authorization: 'Bearer ttp_live_...', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    phoneNumberId: '1122334455',
    to: '15551234567',
    template: { name: 'order_update', language: 'en', parameters: ['Ava', '#4031'] }
  })
});

Webhooks

Ausgehende Webhooks senden Ereignisse im Lebenszyklus von Nachrichten nahezu in Echtzeit an Ihren HTTPS-Endpunkt. Verwalten Sie Endpunkte unter Entwickler → Webhooks — hinzufügen, bearbeiten, pausieren, testen und löschen.

Ereignisse

• Endpunkte müssen sein HTTPS und vom Internet aus erreichbar.
• Jeder Endpunkt abonniert eine ausgewählte Teilmenge von Ereignissen; jedes Ereignis wird mit einer JSON-Nutzlast ausgelöst, die die Nachrichten-ID und den Status enthält.
• Verwenden Sie Test an einem Endpunkt, um eine Beispielzustellung zu senden und Ihren Handler zu überprüfen.
• Pausierte Endpunkte behalten ihre Konfiguration, erhalten jedoch keine Ereignisse mehr.

Ratenlimits

Nachrichten werden mit bis zu der Paketgeschwindigkeit Ihres Plans gesendet. Der tatsächliche Durchsatz kann niedriger sein, wenn Meta Nachrichtenstufen-, Telefonqualitäts- oder kontoweite Beschränkungen anwendet. Nachrichten bleiben sicher in die Warteschlange gestellt statt verworfen zu werden.

Jede Anfrage zählt zu Ihrem API-Aufruf-Kontingent und wird im API-Protokoll mit ihrem Statuscode und der Dauer aufgezeichnet.

Protokolle & Überwachung

Entwickler → Protokolle hält zwei Ansichten:

• API-Protokolle — jeder API-Aufruf: Methode, Endpunkt, HTTP-Status, verwendete Vorlage und Dauer.
• Webhook-Protokolle — jeder Versuch, einen Webhook zu übermitteln, und dessen Ergebnis.

Verwenden Sie sie, um fehlgeschlagene Sendungen zu debuggen, die Zustellung von Webhooks zu bestätigen und Integrationen von Anfang bis Ende zu prüfen.

Fehler

Erfolgreiche Anfragen geben einen 2xx Status zurück. Fehler geben einen Nicht-2xx-Status mit einem JSON-Body zurück, der das Problem beschreibt:

{
  "error": "Template not approved",
  "hint": "Check the template status in Templates — only APPROVED templates can be sent."
}