(temp title) Getting started as a partner

Become a 360dialog partner, integrate your solution and start messaging in less than 1 hour

Welcome to the 360dialog Partner Program! This tutorial will guide you through the essential steps to get started, from creating your Partner Account to sending and receiving your first WhatsApp message.

Prerequisites

Before you begin, ensure you have the following:

• A registered company with relevant details.

• A valid payment method (credit/debit card).

• Access to your company’s logo and name for branding purposes.

• A publicly accessible server to handle webhook events (you can use free providers for testing purposes)

• Basic understanding of REST APIs and webhooks.

Step 1: Create Your Partner Account

1. Access the Partner Portal

Navigate to partner.360dialog.io.

2. Provide Company Details

Enter your organization’s information, including name, address, and contact details.

3. Select Billing Terms

New numbers can be charged under two different ways. Select the one fits better your business model.

• Partner Paid: You handle all billing for your clients.

• Client Paid: Clients are billed directly by 360dialog.

For more details, refer to the Pricing & Billing documentation.

4. Choose a Partner Plan

Choose the one suits better for your needs. Learn more about plan differences here. Plans are billed from the first month.

5. Add your Payment Method

Only cards are available during registration, but you could configure other payment methods in the future.

Step 2: Set Up Number Onboarding

Enable a seamless onboarding experience for your clients.

1. Configure Public Profile

Set your company’s name and logo to be displayed during client onboarding.

• Go to the Partner Hub and update your public profile settings

2. Add Partner Webhook URL

This URL will receive events from 360dialog and Meta, such as account status updates and number registration events.

Ensure your server is set up to handle POST requests at this endpoint.

For testing purposes, you can use a free online webhook testing tools to receive webhook events (like https://webhook.site/ or https://webhook-test.com/)

3. Set Redirect URL

Define where users are redirected after completing the onboarding process.

This could be a confirmation page or your application’s dashboard.

4. Implement the Integrated Onboarding or use a Direct Link

Provide clients with a quick way to register numbers on the WhatsApp API.

Direct Link

• Ensure you correctly pass your 360dialog Partner ID. How to find my 360dialog Partner ID
• You can also preselect the plan you want the number to be onboarded

https://hub.360dialog.com/dashboard/app/
    {YOUR_PARTNER_ID}/
    permissions
    ?plan_selection=regular

Integrated Onboarding Button

We have

• Ensure you correctly pass your Partner ID. How to find my Partner ID

1. Install the package

npm install 360dialog-connect-button

1. Implement the Button component

import { ConnectButton } from '360dialog-connect-button';

function OnboardingPage() {
  return (
    <div>
      <h1>Connect your WhatsApp Business Account</h1>
      <ConnectButton
        partnerId="YOUR_PARTNER_ID"
        onSuccess={(data) => {
          console.log('Client ID:', data.client);
          console.log('Channel IDs:', data.channels);
        }}
      />
    </div>
  );
}

1. After completing onboarding, clients are redirected to your configured Redirect URL with query parameters.

You can also use our Demo app to quickly test.

Find more details about the full implementation here.

We offer other more customizable ways to onboard new numbers that you can implement later on to provide a full custom onboarding experience. More info here

No more configurations, you are ready to register a number 🚀

Step 3: Register Your First WhatsApp API Number

Use the IO Button or Direct Link

Clients can register their WhatsApp Business number using the methods set up in the previous step. Use the Direct Link to easily register your first number or the Button if you have already implemented it in your platform.

While registering a number, you will need to create a Client Account. You should use a different email than your partner user. Just with an alias works ([e-mail]).

Ensure you log out from your Partner HUB account or use a different browser to prevent auth issues.

Step by step guide for the add number flow.

Once the first number is added, you will be able to see it in your partner account.

You will receive notifications in your Partner Webhook URL for every new registered number.

Channel Created

This event is submitted when a new number is created in our system.

Channel created event - webhook payload

{
  "id": "string",
  "event": "channel_created",
  "data": {
    "id": "string",
    "setup_info": {
      "phone_number": "string",
      "phone_name": "string"
    },
    ...
    },
    "waba_account": {...},
    "integration": {...}
  }
}

More details about the webhook event here

Channel Running

This event is submitted when a new number is correctly setup and ready to start messaging.

Channel running event - webhook payload

{
  "id": "string",
  "event": "channel_running",
  "data": {
    "id": "string",
    "setup_info": {
      "phone_number": "string",
      "phone_name": "string"
    },
    ...
    },
    "waba_account": {...},
    "integration": {...}
  }
}

More details about the webhook event here

Other events

Find all the channel events you can receive here:

Webhook Events (Partner & Messaging API)

Step 4: Send and Receive Your First Message

Congratulations, if you are here means you have already registered your first number! 🎉

💬 You are five minutes away from starting to message through WhatsApp API.

1. Generate Number API Key

• Navigate to the Partner Hub.

• Select the registered number and generate an API key. Securely save the Number API Key beacuse we will not display it anymore. If you lose it, you will need to generate a new one.

More info about number API Keys

2. Set Number Webhook

Configure the Number webhook to receive incoming messages and outgoing message statuses.

Use the API endpoint to set the webhook URL for the specific number.

curl -X POST https://waba-v2.360dialog.io/v1/configs/webhook \
  -H "Content-Type: application/json" \
  -H "D360-API-KEY: NUMBER_API_KEY" \
  -d '{
    "url": "YOUR_WEBHOOK_URL",
    "headers": {
      "header_1": "value1",
      "header_2": "value2"
    }
  }'

Remember you can use an online webhook test service for testing purposes.

More info about messaging webhook URL.

3. Receive a Message

Use a wa.me link to send a message to the registered number and start a connversation.

https://wa.me/YOUR_NUMBER_WITH_COUNTRY_CODE

-- Example for Spanish Number ([phone]
https://wa.me/3468098673512

Monitor the number webhook for incoming message events.

Example of Incoming Message Payload

Text Message

{
  "object": "whatsapp_business_account",
  "entry": [{
      "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
      "changes": [{
          "value": {
              "messaging_product": "whatsapp",
              "metadata": {
                  "display_phone_number": PHONE_NUMBER,
                  "phone_number_id": PHONE_NUMBER_ID
              },
              "contacts": [{
                  "profile": {
                    "name": "NAME"
                  },
                  "wa_id": PHONE_NUMBER
                }],
              "messages": [{
                  "from": PHONE_NUMBER,
                  "id": "wamid.ID",
                  "timestamp": TIMESTAMP,
                  "text": {
                    "body": "MESSAGE_BODY"
                  },
                  "type": "text"
                }]
          },
          "field": "messages"
        }]
  }]
}

Find payload examples for other type of messages here.

4. Send a Message:

Now that the conversation has started, you can easily send a message using our Messaging API to answer the incoming message.

POST https://waba-v2.360dialog.io/messages

Body Parameter	Type	Description
recipient_type	string	"individual"
to	string	wa_idof the contact you want to message. This is the phone number including the country code
type	string	"text"
text	object	Contains text-messgae field

Request Example

curl -X POST https://waba-v2.360dialog.io/messages \
  -H "Content-Type: application/json" \
  -H "D360-API-KEY: NUMBER_API_KEY" \
  -d '{
    "recipient_type": "individual",
    "to": "WA_ID",
    "messaging_product": "whatsapp",
    "type": "text",
    "text": {
      "body": "Hello, dear customer!"
    }
  }'

A successful response includes a messages object with an ID for the newly created message.

{
    "messaging_product": "whatsapp",
    "contacts": [
        {
            "input": "16505076520",
            "wa_id": "16505076520"
        }
    ],
    "messages": [
        {
            "id": "wamid.HBgLMTY1MDUwNzY1MjAVAgARGBI5QTNDQTVCM0Q0Q0Q2RTY3RTcA"
        }
    ]
}

For each message you send, you could receive up to 3 webhook events into your Number Webhook URL (for delivered, read and sent statuses). More info here

🚀 Amazing, you are ready to start scaling WhatsApp API for your customers.

Your next step will be to Register your company as a Tech Provider.

Tech Provider Program

Summary

By following this tutorial, you’ve:

• Created a Partner Account with 360dialog.

• Set up Integrated Onboarding for your clients.

• Registered your first WhatsApp Business number.

• Sent and received your first message using the 360dialog API.

For more detailed information, you can navigate through our 360dialog Partner Documentation or reach our to our support team.

🚀 Have a successfull dialog!

---

FAQ

How to find my 360dialog Partner ID

The Partner ID is an unique ID that will be used for most API actions.

The easiest way to find your Partner ID is to log into the 360dialog Partner Hub on your browser and go to the "Partner Integration" section.

Find your Partner ID

To understand more about the Partner ID and credentials, see the Architecture and Security documentation.