Listar as mensagens de uma conversa

curl

curl 'https://api.synergyconnect.com.br/v1/numbers/106540352242922/conversations/4182/messages?limit=20' \
  -H "Authorization: Bearer $SYNERGY_API_KEY"

JavaScript

const res = await fetch('https://api.synergyconnect.com.br/v1/numbers/106540352242922/conversations/4182/messages?limit=20', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.SYNERGY_API_KEY}`,
  },
});
console.log(res.status, await res.json());

Python

import os

import requests

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

200

{
  "data": [
    {
      "id": "wamid.HBgNNTUxMTk5OTk5OTk5ORUCABEYEjdGQjI0QzE4RTlBMDVENzQxAA==",
      "direction": "in",
      "author": "contact",
      "timestamp": "1767225600",
      "status": null,
      "type": "text",
      "message": {
        "from": "5511999999999",
        "id": "wamid.HBgNNTUxMTk5OTk5OTk5ORUCABEYEjdGQjI0QzE4RTlBMDVENzQxAA==",
        "timestamp": "1767225600",
        "type": "text",
        "text": {
          "body": "Oi, meu pedido chegou?"
        },
        "referral": {
          "source_id": "120210000000000123",
          "source_type": "ad",
          "source_url": "https://fb.me/exemplo",
          "headline": "Frete grátis hoje",
          "body": "Peça pelo WhatsApp",
          "media_url": "https://scontent.xx.fbcdn.net/exemplo.jpg"
        }
      },
      "context": null
    },
    {
      "id": "wamid.HBgNNTUxMTk5OTk5OTk5ORUCABEYEjI0QUY0QTk3QjI4QjE4MDBGNQA=",
      "direction": "out",
      "author": "api",
      "timestamp": "1767225590",
      "status": "read",
      "type": "template",
      "message": {
        "type": "template",
        "template": {
          "name": "pedido_enviado",
          "language": {
            "code": "pt_BR"
          }
        }
      },
      "context": null
    }
  ],
  "paging": {
    "before": "WzE3NjcyMjU1OTAwMDAsODEyXQ"
  }
}

400

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

Há 2 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"
  }
}

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

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"
  }
}