Buscar conversas

curl

curl -X POST 'https://api.synergyconnect.com.br/v1/numbers/106540352242922/conversations/search' \
  -H "Authorization: Bearer $SYNERGY_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"q":"Maria","limit":20}'

JavaScript

const res = await fetch('https://api.synergyconnect.com.br/v1/numbers/106540352242922/conversations/search', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SYNERGY_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "q": "Maria",
    "limit": 20
  }),
});
console.log(res.status, await res.json());

Python

import os

import requests

res = requests.post(
    "https://api.synergyconnect.com.br/v1/numbers/106540352242922/conversations/search",
    headers={
        "Authorization": f"Bearer {os.environ['SYNERGY_API_KEY']}",
    },
    json={
        "q": "Maria",
        "limit": 20,
    },
)
print(res.status_code, res.json())

200

{
  "data": [
    {
      "id": "4182",
      "wa_id": "5511999999999",
      "name": "Maria Souza",
      "status": "pending",
      "unread": 2,
      "automation": null,
      "window_expires_at": "1767312000",
      "last_message": {
        "direction": "in",
        "preview": "Oi, meu pedido chegou?",
        "timestamp": "1767225600"
      },
      "attribution": {
        "ad_id": "120210000000000123",
        "headline": "Frete grátis hoje",
        "ad_name": "Frete grátis - vídeo 1",
        "adset_id": "120210000000000456",
        "adset_name": "Público amplo SP",
        "campaign_id": "120210000000000789",
        "campaign_name": "Vendas - outubro",
        "objective": "OUTCOME_SALES",
        "attributable": true,
        "clicked_at": "1767225500"
      }
    }
  ],
  "paging": {
    "after": null
  },
  "rev": 9120
}

400

{
  "error": {
    "message": "(#100) Invalid parameter.",
    "type": "OAuthException",
    "code": 100,
    "error_data": {
      "messaging_product": "whatsapp",
      "details": "Invalid cursor."
    },
    "fbtrace_id": "syn-3f9a1c0b"
  }
}

Há 3 casos com este status; veja a tabela de respostas.

401

{
  "error": {
    "message": "(#190) Invalid OAuth access token.",
    "type": "OAuthException",
    "code": 190,
    "fbtrace_id": "syn-3f9a1c0b"
  }
}

403

{
  "error": {
    "message": "(#200) Permissions error: this key does not have access to this resource.",
    "type": "OAuthException",
    "code": 200,
    "fbtrace_id": "syn-3f9a1c0b"
  }
}

Há 4 casos com este status; veja a tabela de respostas.

404

{
  "error": {
    "message": "(#100) Unsupported request: object does not exist or this key cannot reach it.",
    "type": "OAuthException",
    "code": 100,
    "fbtrace_id": "syn-3f9a1c0b"
  }
}

429

{
  "error": {
    "message": "(#130429) Rate limit hit: the number's message throughput has been reached.",
    "type": "OAuthException",
    "code": 130429,
    "fbtrace_id": "syn-3f9a1c0b"
  }
}

Há 4 casos com este status; veja a tabela de respostas.

503

{
  "error": {
    "message": "(#2) Service temporarily unavailable.",
    "type": "OAuthException",
    "code": 2,
    "fbtrace_id": "syn-3f9a1c0b"
  }
}