Contact

Sends a WhatsApp contact card to a recipient. This message type is ideal for sharing official business contact details and handing off conversations to a real person.

Common use cases:

Customer support handoff
Sales or account manager introduction
Sharing official business contact details
Escalation from automated flows to human support

URL


https://api.messagesmart.nl/api/v1/whatsapp/messages/contact

Headers

See Authentication.

Request body

Field	Type	Required	Notes
whatsAppBusinessId	string	Yes	Can be collected from the dashboard or provided via webhook
whatsAppBusinessPhoneNumberId	string	Yes	Can be collected from the dashboard or provided via webhook
to	string	Yes	Recipient phone number in E.164 format
formattedName	string	Yes	Name shown on the contact card
supportPhone	string	Yes	Phone number shown on the contact card
email	string	No	Email address shown on the contact card
websiteUrl	string	No	Website shown on the contact card
company	string	No	Company name shown on the contact card

Examples

JSON


{
  "whatsAppBusinessId": "123456789012345",
  "whatsAppBusinessPhoneNumberId": "399750423212934",
  "to": "+31622463691",
  "formattedName": "MessageSmart Support",
  "supportPhone": "+31612345678",
  "email": "support@messagesmart.nl",
  "websiteUrl": "https://www.messagesmart.nl",
  "company": "MessageSmart"
}

cURL


curl -X POST "https://api.messagesmart.nl/api/v1/whatsapp/messages/contact" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "whatsAppBusinessId": "123456789012345",
    "whatsAppBusinessPhoneNumberId": "399750423212934",
    "to": "+31622463691",
    "formattedName": "MessageSmart Support",
    "supportPhone": "+31612345678",
    "email": "support@messagesmart.nl",
    "websiteUrl": "https://www.messagesmart.nl",
    "company": "MessageSmart"
  }'

Node.js


const response = await fetch(
  "https://api.messagesmart.nl/api/v1/whatsapp/messages/contact",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.MESSAGESMART_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      whatsAppBusinessId: "123456789012345",
      whatsAppBusinessPhoneNumberId: "399750423212934",
      to: "+31622463691",
      formattedName: "MessageSmart Support",
      supportPhone: "+31612345678",
      email: "support@messagesmart.nl",
      websiteUrl: "https://www.messagesmart.nl",
      company: "MessageSmart",
    }),
  }
);
 
const json = await response.json();
console.log(json);
 
if (!json.success) {
  throw new Error(`${json.error.code}: ${json.error.message}`);
}

Response

Success (200 OK)


{
  "success": true,
  "data": {
    "messaging_product": "whatsapp",
    "contacts": [
      {
        "input": "+31622463691",
        "wa_id": "31622463691"
      }
    ],
    "messages": [
      {
        "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA"
      }
    ]
  }
}

Field explanation

data.contacts[0] — contact shared with the recipient
data.messages[0].id — WhatsApp message ID

Validation error (400 Bad Request)


{
  "success": false,
  "error": {
    "code": "validation_error",
    "message": "Invalid request body",
    "httpStatus": 400,
    "details": null
  }
}

Common causes:

Missing formattedName or supportPhone
Missing to
Missing WhatsApp business identifiers

Provider error (502 Bad Gateway)


{
  "success": false,
  "error": {
    "code": "WHATSAPP_SEND_FAILED",
    "message": "Failed to send WhatsApp contact message.",
    "httpStatus": 502,
    "details": {
      "provider": "meta",
      "raw": {}
    }
  }
}