Vercel AI SDK tools to send SMS and email

1. Set the key

Create an API key in the Hail console and expose it to your server runtime only.

# .env.local
HAIL_API_KEY="hl_live_9fa2..."

2. Define the tools

The AI SDK's tool() takes a Zod schema and an execute function. recipient_consent is a required field. The API refuses a send without it.

import { generateText, tool } from "ai";
import { z } from "zod";

const hail = (path: string, body: unknown) =>
  fetch(`https://api.hail.so${path}`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.HAIL_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(body),
  }).then((r) => r.json());

const sendSms = tool({
  description: "Text an opted-in recipient.",
  inputSchema: z.object({ to: z.string(), body: z.string() }),
  execute: ({ to, body }) =>
    hail("/sms", { to, body, recipient_consent: true }),
});

3. Use them in generateText

The model selects the tool. Hail sends delivery events to your webhook.

const { text } = await generateText({
  model: "anthropic/claude-sonnet-5",
  tools: { sendSms },
  prompt: "Text +14155550142 that order 4471 shipped.",
});

Questions

Run the examples

The examples above run as written with a Hail account and an API key. You pay for usage.