WhatsApp integration

apps/docs/examples/examples.mdx

@@ -20,4 +20,7 @@ You can use these workflows in your product by following the instructions on eac
   <Card title="Resend" icon="envelope" href="/examples/resend">
     Create a welcome email drip campaign.
   </Card>
+  <Card title="WhatsApp" icon="whatsapp" href="/examples/whatsapp">
+    Listen for WhatsApp messages and reply.
+  </Card>
 </CardGroup>

apps/docs/examples/whatsapp.mdx

@@ -0,0 +1,48 @@
+---
+title: "WhatsApp"
+sidebarTitle: "WhatsApp"
+description: "Here are some example workflows you could create using the WhatsApp integration."
+---
+
+For more information about the WhatsApp integration, check out the [integration page](/integrations/apis/whatsapp).
+
+## Listen for WhatsApp messages and reply
+
+Integrations required: WhatsApp
+
+```ts
+import { Trigger } from "@trigger.dev/sdk";
+import { events, sendReaction, sendText } from "@trigger.dev/whatsapp";
+
+new Trigger({
+  id: "whatsapp-webhook",
+  name: "Listen for WhatsApp messages and reply",
+  apiKey: "<my_api_key>",
+  //this listens for all WhatsApp messages sent to your WhatsApp Business account
+  on: events.messageEvent({
+    accountId: "<your_account_id>",
+  }),
+  run: async (event, ctx) => {
+    //these logs will appear on the run page
+    await ctx.logger.info(`Message data`, event.message);
+    await ctx.logger.info(`Phone number`, event.contacts[0]);
+
+    //add a 🥰 reaction to the original message
+    const reactionResponse = await sendReaction("reaction", {
+      fromId: event.metadata.phone_number_id,
+      to: event.message.from,
+      isReplyTo: event.message.id,
+      emoji: "🥰",
+    });
+
+    //send a text message in response
+    const textResponse = await sendText("text-msg", {
+      fromId: event.metadata.phone_number_id,
+      to: event.message.from,
+      text: "Hello! This is a text sent automatically from https://www.trigger.dev",
+    });
+
+    //we support all other types of WhatsApp messages (audio, video, document, location, etc)
+  },
+}).listen();
+```

apps/docs/integrations/apis/whatsapp/actions/audio-message.mdx

@@ -0,0 +1,94 @@
+---
+title: "Send Audio Message"
+sidebarTitle: "Audio Message"
+description: "Post a audio message to WhatsApp"
+---
+
+Send WhatsApp audio messages from your WhatsApp Business Account.
+
+## Params
+
+<ParamField path="key" type="string" required={true}>
+  A unique string. Please see the [Keys and Resumability](/guides/resumability)
+  doc for more info.
+</ParamField>
+
+<ParamField path="message" type="object" required={true}>
+  <Expandable title="properties" defaultOpen={true}>
+    <ParamField path="fromId" type="string" required={false}>
+      The id of the phone number you want to send the message from. You can find this in the your WhatsApp Business dashboard. Note, this is not the phone number.
+    </ParamField>
+
+    <ParamField path="to" type="string" required={false}>
+      The phone number you want to send the message to.
+    </ParamField>
+
+    <ParamField path="url" type="string" required={true}>
+      The url of the audio file to be sent.
+    </ParamField>
+
+    <ParamField path="isReplyTo" type="string" required={false}>
+      Optionally, add the id of the message you want to reply to. It will appear as a reply in the WhatsApp chat.
+    </ParamField>
+
+  </Expandable>
+</ParamField>
+
+## Response
+
+<ResponseField name="contacts" type="object">
+  The contact information of who received the message
+</ResponseField>
+
+<ResponseField name="messages" type="object">
+  An array of message ids that were sent
+</ResponseField>
+
+<ResponseField name="messaging_product" type="string">
+  Always `whatsapp`
+</ResponseField>
+
+## Example Workflows
+
+### Notify Slack on New GitHub Star
+
+<CodeGroup>
+
+```typescript Automated reply to WhatsApp messages
+import { Trigger } from "@trigger.dev/sdk";
+import { events, sendAudio } from "@trigger.dev/whatsapp";
+
+new Trigger({
+  id: "demo",
+  on: events.messageEvent({
+    accountId: "<account_id>",
+  }),
+  run: async (event, ctx) => {
+    //send an automatic audio reply to the message
+    const audioResponse = await sendAudio("audio", {
+      fromId: event.metadata.phone_number_id,
+      to: event.message.from,
+      url: "https://ssl.gstatic.com/dictionary/static/pronunciation/2022-03-02/audio/wi/wikipedia_en_gb_1.mp3",
+    });
+  },
+}).listen();
+```
+
+```json Example response
+{
+  "contacts": [
+    {
+      "input": "12345678901",
+      "wa_id": "12345678901"
+    }
+  ],
+  "messages": [
+    {
+      "id": "wamid.ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"
+    }
+  ],
+  "messaging_product": "whatsapp"
+}
+```
+
+</CodeGroup>

apps/docs/integrations/apis/whatsapp/actions/contacts-message.mdx

@@ -0,0 +1,103 @@
+---
+title: "Send a Contacts Message"
+sidebarTitle: "Contacts Message"
+description: "Post a contacts message to WhatsApp"
+---
+
+Send WhatsApp contacts messages from your WhatsApp Business Account.
+
+## Params
+
+<ParamField path="key" type="string" required={true}>
+  A unique string. Please see the [Keys and Resumability](/guides/resumability)
+  doc for more info.
+</ParamField>
+
+<ParamField path="message" type="object" required={true}>
+  <Expandable title="properties" defaultOpen={true}>
+    <ParamField path="fromId" type="string" required={false}>
+      The id of the phone number you want to send the message from. You can find this in the your WhatsApp Business dashboard. Note, this is not the phone number.
+    </ParamField>
+
+    <ParamField path="to" type="string" required={false}>
+      The phone number you want to send the message to.
+    </ParamField>
+
+    <ParamField path="contacts" type="object" required={true}>
+      An array of contacts to be sent.
+    </ParamField>
+
+  </Expandable>
+</ParamField>
+
+## Response
+
+<ResponseField name="contacts" type="object">
+  The contact information of who received the message
+</ResponseField>
+
+<ResponseField name="messages" type="object">
+  An array of message ids that were sent
+</ResponseField>
+
+<ResponseField name="messaging_product" type="string">
+  Always `whatsapp`
+</ResponseField>
+
+## Example Workflows
+
+### Notify Slack on New GitHub Star
+
+<CodeGroup>
+
+```typescript Automated reply to WhatsApp messages
+import { Trigger } from "@trigger.dev/sdk";
+import { events, sendVideo } from "@trigger.dev/whatsapp";
+
+new Trigger({
+  id: "demo",
+  on: events.messageEvent({
+    accountId: "<account_id>",
+  }),
+  run: async (event, ctx) => {
+    //send an contacts message
+    const contactsResponse = await sendContacts("contacts", {
+      fromId: event.metadata.phone_number_id,
+      to: event.message.from,
+      contacts: [
+        {
+          name: {
+            first_name: "Matt",
+            last_name: "Aitken",
+            formatted_name: "Matt Aitken",
+          },
+          phones: [
+            {
+              phone: "+12345678901",
+            },
+          ],
+        },
+      ],
+    });
+  },
+}).listen();
+```
+
+```json Example response
+{
+  "contacts": [
+    {
+      "input": "12345678901",
+      "wa_id": "12345678901"
+    }
+  ],
+  "messages": [
+    {
+      "id": "wamid.ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"
+    }
+  ],
+  "messaging_product": "whatsapp"
+}
+```
+
+</CodeGroup>

apps/docs/integrations/apis/whatsapp/actions/document-message.mdx

@@ -0,0 +1,99 @@
+---
+title: "Send Document Message"
+sidebarTitle: "Document Message"
+description: "Post a document message to WhatsApp"
+---
+
+Send WhatsApp document messages from your WhatsApp Business Account.
+
+## Params
+
+<ParamField path="key" type="string" required={true}>
+  A unique string. Please see the [Keys and Resumability](/guides/resumability)
+  doc for more info.
+</ParamField>
+
+<ParamField path="message" type="object" required={true}>
+  <Expandable title="properties" defaultOpen={true}>
+    <ParamField path="fromId" type="string" required={false}>
+      The id of the phone number you want to send the message from. You can find this in the your WhatsApp Business dashboard. Note, this is not the phone number.
+    </ParamField>
+
+    <ParamField path="to" type="string" required={false}>
+      The phone number you want to send the message to.
+    </ParamField>
+
+    <ParamField path="url" type="string" required={true}>
+      The url of the document to be sent.
+    </ParamField>
+
+    <ParamField path="caption" type="string" required={false}>
+      Optional caption that sits below the video
+    </ParamField>
+
+    <ParamField path="isReplyTo" type="string" required={false}>
+      Optionally, add the id of the message you want to reply to. It will appear as a reply in the WhatsApp chat.
+    </ParamField>
+
+  </Expandable>
+</ParamField>
+
+## Response
+
+<ResponseField name="contacts" type="object">
+  The contact information of who received the message
+</ResponseField>
+
+<ResponseField name="messages" type="object">
+  An array of message ids that were sent
+</ResponseField>
+
+<ResponseField name="messaging_product" type="string">
+  Always `whatsapp`
+</ResponseField>
+
+## Example Workflows
+
+### Notify Slack on New GitHub Star
+
+<CodeGroup>
+
+```typescript Automated reply to WhatsApp messages
+import { Trigger } from "@trigger.dev/sdk";
+import { events, sendDocument } from "@trigger.dev/whatsapp";
+
+new Trigger({
+  id: "demo",
+  on: events.messageEvent({
+    accountId: "<account_id>",
+  }),
+  run: async (event, ctx) => {
+    //send an automatic document reply to the message
+    const documentResponse = await sendDocument("doc", {
+      fromId: event.metadata.phone_number_id,
+      to: event.message.from,
+      url: "https://upload.wikimedia.org/wikipedia/commons/2/20/Re_example.pdf",
+      caption: "A pdf for you",
+    });
+  },
+}).listen();
+```
+
+```json Example response
+{
+  "contacts": [
+    {
+      "input": "12345678901",
+      "wa_id": "12345678901"
+    }
+  ],
+  "messages": [
+    {
+      "id": "wamid.ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"
+    }
+  ],
+  "messaging_product": "whatsapp"
+}
+```
+
+</CodeGroup>