Create a greeting
curl --request POST \
--url https://api.meetdarwin.ai/v1/link_greetings \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"text": "<string>",
"buttons": [
{
"label": "<string>",
"message": "<string>"
}
],
"agent_note": "<string>"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
text: '<string>',
buttons: [{label: '<string>', message: '<string>'}],
agent_note: '<string>'
})
};
fetch('https://api.meetdarwin.ai/v1/link_greetings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.meetdarwin.ai/v1/link_greetings"
payload = {
"name": "<string>",
"text": "<string>",
"buttons": [
{
"label": "<string>",
"message": "<string>"
}
],
"agent_note": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "gr_m3k8wq",
"object": "link_greeting",
"name": "<string>",
"text": "Hi {first|there}, want to see what we could do for {company|your team}?",
"buttons": [
{
"label": "<string>",
"message": "<string>"
}
],
"agent_note": "<string>",
"fields": [
"<string>"
],
"preview": {
"with_details": "<string>",
"without_details": "<string>",
"buttons": [
"<string>"
]
},
"links": 0,
"results": {
"days": 0,
"visits": 0,
"chats": 0,
"meetings": 0
}
}{
"type": "https://docs.meetdarwin.ai/api-reference/errors#insufficient_scope",
"title": "<string>",
"status": 0,
"code": "insufficient_scope",
"detail": "<string>",
"request_id": "req_8m2k4p0q1x7z9c3v5b6n",
"param": "<string>"
}{
"type": "https://docs.meetdarwin.ai/api-reference/errors#insufficient_scope",
"title": "<string>",
"status": 0,
"code": "insufficient_scope",
"detail": "<string>",
"request_id": "req_8m2k4p0q1x7z9c3v5b6n",
"param": "<string>"
}{
"type": "https://docs.meetdarwin.ai/api-reference/errors#insufficient_scope",
"title": "<string>",
"status": 0,
"code": "insufficient_scope",
"detail": "<string>",
"request_id": "req_8m2k4p0q1x7z9c3v5b6n",
"param": "<string>"
}{
"type": "https://docs.meetdarwin.ai/api-reference/errors#insufficient_scope",
"title": "<string>",
"status": 0,
"code": "insufficient_scope",
"detail": "<string>",
"request_id": "req_8m2k4p0q1x7z9c3v5b6n",
"param": "<string>"
}{
"type": "https://docs.meetdarwin.ai/api-reference/errors#insufficient_scope",
"title": "<string>",
"status": 0,
"code": "insufficient_scope",
"detail": "<string>",
"request_id": "req_8m2k4p0q1x7z9c3v5b6n",
"param": "<string>"
}{
"type": "https://docs.meetdarwin.ai/api-reference/errors#insufficient_scope",
"title": "<string>",
"status": 0,
"code": "insufficient_scope",
"detail": "<string>",
"request_id": "req_8m2k4p0q1x7z9c3v5b6n",
"param": "<string>"
}{
"type": "https://docs.meetdarwin.ai/api-reference/errors#insufficient_scope",
"title": "<string>",
"status": 0,
"code": "insufficient_scope",
"detail": "<string>",
"request_id": "req_8m2k4p0q1x7z9c3v5b6n",
"param": "<string>"
}{
"type": "https://docs.meetdarwin.ai/api-reference/errors#insufficient_scope",
"title": "<string>",
"status": 0,
"code": "insufficient_scope",
"detail": "<string>",
"request_id": "req_8m2k4p0q1x7z9c3v5b6n",
"param": "<string>"
}Personal links
Create a greeting
Requires the agent:write scope.
POST
/
link_greetings
Create a greeting
curl --request POST \
--url https://api.meetdarwin.ai/v1/link_greetings \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"text": "<string>",
"buttons": [
{
"label": "<string>",
"message": "<string>"
}
],
"agent_note": "<string>"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
text: '<string>',
buttons: [{label: '<string>', message: '<string>'}],
agent_note: '<string>'
})
};
fetch('https://api.meetdarwin.ai/v1/link_greetings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.meetdarwin.ai/v1/link_greetings"
payload = {
"name": "<string>",
"text": "<string>",
"buttons": [
{
"label": "<string>",
"message": "<string>"
}
],
"agent_note": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "gr_m3k8wq",
"object": "link_greeting",
"name": "<string>",
"text": "Hi {first|there}, want to see what we could do for {company|your team}?",
"buttons": [
{
"label": "<string>",
"message": "<string>"
}
],
"agent_note": "<string>",
"fields": [
"<string>"
],
"preview": {
"with_details": "<string>",
"without_details": "<string>",
"buttons": [
"<string>"
]
},
"links": 0,
"results": {
"days": 0,
"visits": 0,
"chats": 0,
"meetings": 0
}
}{
"type": "https://docs.meetdarwin.ai/api-reference/errors#insufficient_scope",
"title": "<string>",
"status": 0,
"code": "insufficient_scope",
"detail": "<string>",
"request_id": "req_8m2k4p0q1x7z9c3v5b6n",
"param": "<string>"
}{
"type": "https://docs.meetdarwin.ai/api-reference/errors#insufficient_scope",
"title": "<string>",
"status": 0,
"code": "insufficient_scope",
"detail": "<string>",
"request_id": "req_8m2k4p0q1x7z9c3v5b6n",
"param": "<string>"
}{
"type": "https://docs.meetdarwin.ai/api-reference/errors#insufficient_scope",
"title": "<string>",
"status": 0,
"code": "insufficient_scope",
"detail": "<string>",
"request_id": "req_8m2k4p0q1x7z9c3v5b6n",
"param": "<string>"
}{
"type": "https://docs.meetdarwin.ai/api-reference/errors#insufficient_scope",
"title": "<string>",
"status": 0,
"code": "insufficient_scope",
"detail": "<string>",
"request_id": "req_8m2k4p0q1x7z9c3v5b6n",
"param": "<string>"
}{
"type": "https://docs.meetdarwin.ai/api-reference/errors#insufficient_scope",
"title": "<string>",
"status": 0,
"code": "insufficient_scope",
"detail": "<string>",
"request_id": "req_8m2k4p0q1x7z9c3v5b6n",
"param": "<string>"
}{
"type": "https://docs.meetdarwin.ai/api-reference/errors#insufficient_scope",
"title": "<string>",
"status": 0,
"code": "insufficient_scope",
"detail": "<string>",
"request_id": "req_8m2k4p0q1x7z9c3v5b6n",
"param": "<string>"
}{
"type": "https://docs.meetdarwin.ai/api-reference/errors#insufficient_scope",
"title": "<string>",
"status": 0,
"code": "insufficient_scope",
"detail": "<string>",
"request_id": "req_8m2k4p0q1x7z9c3v5b6n",
"param": "<string>"
}{
"type": "https://docs.meetdarwin.ai/api-reference/errors#insufficient_scope",
"title": "<string>",
"status": 0,
"code": "insufficient_scope",
"detail": "<string>",
"request_id": "req_8m2k4p0q1x7z9c3v5b6n",
"param": "<string>"
}Authorizations
A secret key (dk_live_…). Scopes: conversations:read, contacts:read, contacts:write, meetings:read, analytics:read, events:read, webhooks:write, knowledge:read, knowledge:write, agent:read, agent:write, experiments:read, experiments:write, privacy:write, chat:write.
Headers
Retry safely: the first response is replayed for 24 hours (not for streamed answers).
Maximum string length:
255Body
application/json
What your team calls it.
Required string length:
1 - 60What the chat says. Put a person's details in braces with words for when the link has none: {first|there}, {company|your team}, {title}, {last}. A field with no fallback is left out with the space before it.
Required string length:
1 - 200Up to four reply buttons. They replace the page's own; an empty list keeps the page's.
Maximum array length:
4Show child attributes
Show child attributes
What the agent should know about people you send this to, e.g. why you reached out. Fields allowed. Null or empty removes it.
Maximum string length:
500Response
OK
Pattern:
^gr_Example:
"gr_m3k8wq"
Allowed value:
"link_greeting"Example:
"Hi {first|there}, want to see what we could do for {company|your team}?"
Show child attributes
Show child attributes
What the agent is told about people shown this greeting.
Show child attributes
Show child attributes
How many links use it.
Required range:
-9007199254740991 <= x <= 9007199254740991The last 30 days: people who opened it, how many of them chatted, and how many booked. Your team's and test visits are left out.
Show child attributes
Show child attributes