TypeScript SDK

import { createClient } from "@messages-dev/sdk";

const client = createClient();

const client = createClient({ apiKey: "sk_live_..." });

await client.sendMessage({
  from: "+15551234567",
  to: "+15559876543",
  text: "Hello from Messages.dev!",
});

import { verifyWebhook } from "@messages-dev/sdk";

app.post("/webhooks", async (req, res) => {
  const event = await verifyWebhook(
    req.body,
    req.headers["x-webhook-signature"],
    "your_webhook_secret",
  );

  switch (event.event) {
    case "message.received":
      console.log(`New message from ${event.data.sender}: ${event.data.text}`);
      break;
    case "message.sent":
      console.log(`Message delivered: ${event.data.id}`);
      break;
  }

  res.sendStatus(200);
});

const messages = await client.listMessages({
  from: "+15551234567",
  to: "+15559876543",
});

await client.sendReaction({
  from: "+15551234567",
  to: "+15559876543",
  messageId: "msg_abc123",
  type: "love",
});

const reactions = await client.listReactions({
  messageId: "msg_abc123",
});

await client.startTyping({
  from: "+15551234567",
  to: "+15559876543",
});

await client.stopTyping({
  from: "+15551234567",
  to: "+15559876543",
});

await client.sendReadReceipt({
  from: "+15551234567",
  to: "+15559876543",
});

const receipts = await client.listReadReceipts({
  from: "+15551234567",
  to: "+15559876543",
});

const file = await client.uploadFile({
  from: "+15551234567",
  file: Buffer.from(imageData),
  filename: "photo.jpg",
  mimeType: "image/jpeg",
});
await client.sendMessage({
  from: "+15551234567",
  to: "+15559876543",
  text: "Check this out!",
  attachments: [file.id],
});

const { url } = await client.getFileUrl({ id: "file_abc123" });

await client.getOutboxItem({ id: "obx_xyz789" });

const lines = await client.listLines();

for (const line of lines.data) {
  console.log(line.handle, line.service, line.isActive);
}

const chats = await client.listChats({
  from: "+15551234567",
});

for (const chat of chats.data) {
  console.log(chat.identifier, chat.name, chat.lastMessageAt);
}

await client.createWebhook({
  from: "+15551234567",
  url: "https://example.com/webhooks",
  events: ["message.received", "message.sent"],
});

const webhooks = await client.listWebhooks({
  from: "+15551234567",
});

await client.deleteWebhook({ id: "wh_abc123" });

const page = await client.listMessages({
  from: "+15551234567",
  to: "+15559876543",
  limit: 10,
});

if (page.hasMore) {
  const nextPage = await client.listMessages({
    from: "+15551234567",
    to: "+15559876543",
    cursor: page.nextCursor,
  });
}

const messages = await client.listMessages({
  from: "+15551234567",
  to: "+15559876543",
});

for await (const message of messages) {
  console.log(message.text);
}

import { createClient, AuthenticationError, AuthorizationError, InvalidRequestError, NotFoundError } from "@messages-dev/sdk";

try {
  await client.sendMessage({
    from: "+15551234567",
    to: "+15559876543",
    text: "Hello!",
  });
} catch (err) {
  if (err instanceof AuthenticationError) {
    console.error("Bad API key:", err.code);
  } else if (err instanceof AuthorizationError) {
    console.error("Forbidden:", err.code);
  } else if (err instanceof InvalidRequestError) {
    console.error("Bad request:", err.code, err.param);
  } else if (err instanceof NotFoundError) {
    console.error("Not found:", err.code);
  }
}

const client = createClient({
  apiKey: "sk_live_...",
  baseUrl: "https://api.messages.dev",
  timeout: 30_000,
  maxRetries: 2,
});

import { createClient } from "@messages-dev/sdk";
import type {
  Line,
  Chat,
  Message,
  Reaction,
  Webhook,
  OutboxItem,
  WebhookEvent,
} from "@messages-dev/sdk";