Enviar localização geográfica

curl --request POST \
  --url https://api.wppfy.com/send/location \
  --header 'Content-Type: application/json' \
  --header 'token: <api-key>' \
  --data '
{
  "number": "5511999999999",
  "latitude": -23.5616,
  "longitude": -46.6562,
  "name": "MASP",
  "address": "Av. Paulista, 1578 - Bela Vista",
  "replyid": "3EB0538DA65A59F6D8A251",
  "mentions": "5511999999999,5511888888888",
  "readchat": true,
  "readmessages": true,
  "delay": 1000,
  "forward": true,
  "track_source": "chatwoot",
  "track_id": "msg_123456789"
}
'

import requests

url = "https://api.wppfy.com/send/location"

payload = {
    "number": "5511999999999",
    "latitude": -23.5616,
    "longitude": -46.6562,
    "name": "MASP",
    "address": "Av. Paulista, 1578 - Bela Vista",
    "replyid": "3EB0538DA65A59F6D8A251",
    "mentions": "5511999999999,5511888888888",
    "readchat": True,
    "readmessages": True,
    "delay": 1000,
    "forward": True,
    "track_source": "chatwoot",
    "track_id": "msg_123456789"
}
headers = {
    "token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {token: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    number: '5511999999999',
    latitude: -23.5616,
    longitude: -46.6562,
    name: 'MASP',
    address: 'Av. Paulista, 1578 - Bela Vista',
    replyid: '3EB0538DA65A59F6D8A251',
    mentions: '5511999999999,5511888888888',
    readchat: true,
    readmessages: true,
    delay: 1000,
    forward: true,
    track_source: 'chatwoot',
    track_id: 'msg_123456789'
  })
};

fetch('https://api.wppfy.com/send/location', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.wppfy.com/send/location",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'number' => '5511999999999',
    'latitude' => -23.5616,
    'longitude' => -46.6562,
    'name' => 'MASP',
    'address' => 'Av. Paulista, 1578 - Bela Vista',
    'replyid' => '3EB0538DA65A59F6D8A251',
    'mentions' => '5511999999999,5511888888888',
    'readchat' => true,
    'readmessages' => true,
    'delay' => 1000,
    'forward' => true,
    'track_source' => 'chatwoot',
    'track_id' => 'msg_123456789'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.wppfy.com/send/location"

	payload := strings.NewReader("{\n  \"number\": \"5511999999999\",\n  \"latitude\": -23.5616,\n  \"longitude\": -46.6562,\n  \"name\": \"MASP\",\n  \"address\": \"Av. Paulista, 1578 - Bela Vista\",\n  \"replyid\": \"3EB0538DA65A59F6D8A251\",\n  \"mentions\": \"5511999999999,5511888888888\",\n  \"readchat\": true,\n  \"readmessages\": true,\n  \"delay\": 1000,\n  \"forward\": true,\n  \"track_source\": \"chatwoot\",\n  \"track_id\": \"msg_123456789\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.wppfy.com/send/location")
  .header("token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"number\": \"5511999999999\",\n  \"latitude\": -23.5616,\n  \"longitude\": -46.6562,\n  \"name\": \"MASP\",\n  \"address\": \"Av. Paulista, 1578 - Bela Vista\",\n  \"replyid\": \"3EB0538DA65A59F6D8A251\",\n  \"mentions\": \"5511999999999,5511888888888\",\n  \"readchat\": true,\n  \"readmessages\": true,\n  \"delay\": 1000,\n  \"forward\": true,\n  \"track_source\": \"chatwoot\",\n  \"track_id\": \"msg_123456789\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.wppfy.com/send/location")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"number\": \"5511999999999\",\n  \"latitude\": -23.5616,\n  \"longitude\": -46.6562,\n  \"name\": \"MASP\",\n  \"address\": \"Av. Paulista, 1578 - Bela Vista\",\n  \"replyid\": \"3EB0538DA65A59F6D8A251\",\n  \"mentions\": \"5511999999999,5511888888888\",\n  \"readchat\": true,\n  \"readmessages\": true,\n  \"delay\": 1000,\n  \"forward\": true,\n  \"track_source\": \"chatwoot\",\n  \"track_id\": \"msg_123456789\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "messageid": "<string>",
  "chatid": "<string>",
  "fromMe": false,
  "isGroup": false,
  "messageTimestamp": 0,
  "edited": "",
  "quoted": "",
  "reaction": "",
  "sender": "",
  "senderName": "",
  "source": "",
  "status": "",
  "text": "",
  "vote": "",
  "buttonOrListid": "",
  "convertOptions": "",
  "fileURL": "",
  "content": "<string>",
  "owner": "",
  "track_source": "",
  "track_id": "",
  "created": "(strftime('%Y-%m-%d %H:%M:%f', 'now'))",
  "updated": "(strftime('%Y-%m-%d %H:%M:%f', 'now'))",
  "ai_metadata": {
    "agent_id": "<string>",
    "request": {
      "messages": "<array>",
      "tools": "<array>",
      "options": {
        "model": "<string>",
        "temperature": 123,
        "maxTokens": 123,
        "topP": 123,
        "frequencyPenalty": 123,
        "presencePenalty": 123
      }
    },
    "response": {
      "choices": "<array>",
      "toolResults": "<array>",
      "error": "<string>"
    }
  },
  "response": {
    "status": "success",
    "message": "Location sent successfully"
  }
}

{
  "error": "Invalid coordinates or missing number"
}

{
  "error": "Invalid token"
}

{
  "error": "Rate limit exceeded"
}

{
  "error": "Failed to send location"
}

Enviar Mensagem

Enviar localização geográfica

Envia uma localização geográfica para um contato ou grupo.

Recursos Específicos

Coordenadas precisas (latitude e longitude obrigatórias)
Nome do local para identificação
Mapa interativo no WhatsApp para navegação
Pin personalizado com nome do local

Campos Comuns

Este endpoint suporta todos os campos opcionais comuns documentados na tag “Enviar Mensagem”, incluindo: delay, readchat, readmessages, replyid, mentions, forward, track_source, track_id, placeholders e envio para grupos.

Exemplo Básico

{
  "number": "5511999999999",
  "name": "Maracanã",
  "address": "Av. Pres. Castelo Branco, Portão 3 - Maracanã, Rio de Janeiro - RJ, 20271-130",
  "latitude": -22.912982815767986,
  "longitude": -43.23028153499254
}

POST

send

location

Enviar localização geográfica

curl --request POST \
  --url https://api.wppfy.com/send/location \
  --header 'Content-Type: application/json' \
  --header 'token: <api-key>' \
  --data '
{
  "number": "5511999999999",
  "latitude": -23.5616,
  "longitude": -46.6562,
  "name": "MASP",
  "address": "Av. Paulista, 1578 - Bela Vista",
  "replyid": "3EB0538DA65A59F6D8A251",
  "mentions": "5511999999999,5511888888888",
  "readchat": true,
  "readmessages": true,
  "delay": 1000,
  "forward": true,
  "track_source": "chatwoot",
  "track_id": "msg_123456789"
}
'

import requests

url = "https://api.wppfy.com/send/location"

payload = {
    "number": "5511999999999",
    "latitude": -23.5616,
    "longitude": -46.6562,
    "name": "MASP",
    "address": "Av. Paulista, 1578 - Bela Vista",
    "replyid": "3EB0538DA65A59F6D8A251",
    "mentions": "5511999999999,5511888888888",
    "readchat": True,
    "readmessages": True,
    "delay": 1000,
    "forward": True,
    "track_source": "chatwoot",
    "track_id": "msg_123456789"
}
headers = {
    "token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {token: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    number: '5511999999999',
    latitude: -23.5616,
    longitude: -46.6562,
    name: 'MASP',
    address: 'Av. Paulista, 1578 - Bela Vista',
    replyid: '3EB0538DA65A59F6D8A251',
    mentions: '5511999999999,5511888888888',
    readchat: true,
    readmessages: true,
    delay: 1000,
    forward: true,
    track_source: 'chatwoot',
    track_id: 'msg_123456789'
  })
};

fetch('https://api.wppfy.com/send/location', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.wppfy.com/send/location",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'number' => '5511999999999',
    'latitude' => -23.5616,
    'longitude' => -46.6562,
    'name' => 'MASP',
    'address' => 'Av. Paulista, 1578 - Bela Vista',
    'replyid' => '3EB0538DA65A59F6D8A251',
    'mentions' => '5511999999999,5511888888888',
    'readchat' => true,
    'readmessages' => true,
    'delay' => 1000,
    'forward' => true,
    'track_source' => 'chatwoot',
    'track_id' => 'msg_123456789'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.wppfy.com/send/location"

	payload := strings.NewReader("{\n  \"number\": \"5511999999999\",\n  \"latitude\": -23.5616,\n  \"longitude\": -46.6562,\n  \"name\": \"MASP\",\n  \"address\": \"Av. Paulista, 1578 - Bela Vista\",\n  \"replyid\": \"3EB0538DA65A59F6D8A251\",\n  \"mentions\": \"5511999999999,5511888888888\",\n  \"readchat\": true,\n  \"readmessages\": true,\n  \"delay\": 1000,\n  \"forward\": true,\n  \"track_source\": \"chatwoot\",\n  \"track_id\": \"msg_123456789\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.wppfy.com/send/location")
  .header("token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"number\": \"5511999999999\",\n  \"latitude\": -23.5616,\n  \"longitude\": -46.6562,\n  \"name\": \"MASP\",\n  \"address\": \"Av. Paulista, 1578 - Bela Vista\",\n  \"replyid\": \"3EB0538DA65A59F6D8A251\",\n  \"mentions\": \"5511999999999,5511888888888\",\n  \"readchat\": true,\n  \"readmessages\": true,\n  \"delay\": 1000,\n  \"forward\": true,\n  \"track_source\": \"chatwoot\",\n  \"track_id\": \"msg_123456789\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.wppfy.com/send/location")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"number\": \"5511999999999\",\n  \"latitude\": -23.5616,\n  \"longitude\": -46.6562,\n  \"name\": \"MASP\",\n  \"address\": \"Av. Paulista, 1578 - Bela Vista\",\n  \"replyid\": \"3EB0538DA65A59F6D8A251\",\n  \"mentions\": \"5511999999999,5511888888888\",\n  \"readchat\": true,\n  \"readmessages\": true,\n  \"delay\": 1000,\n  \"forward\": true,\n  \"track_source\": \"chatwoot\",\n  \"track_id\": \"msg_123456789\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "messageid": "<string>",
  "chatid": "<string>",
  "fromMe": false,
  "isGroup": false,
  "messageTimestamp": 0,
  "edited": "",
  "quoted": "",
  "reaction": "",
  "sender": "",
  "senderName": "",
  "source": "",
  "status": "",
  "text": "",
  "vote": "",
  "buttonOrListid": "",
  "convertOptions": "",
  "fileURL": "",
  "content": "<string>",
  "owner": "",
  "track_source": "",
  "track_id": "",
  "created": "(strftime('%Y-%m-%d %H:%M:%f', 'now'))",
  "updated": "(strftime('%Y-%m-%d %H:%M:%f', 'now'))",
  "ai_metadata": {
    "agent_id": "<string>",
    "request": {
      "messages": "<array>",
      "tools": "<array>",
      "options": {
        "model": "<string>",
        "temperature": 123,
        "maxTokens": 123,
        "topP": 123,
        "frequencyPenalty": 123,
        "presencePenalty": 123
      }
    },
    "response": {
      "choices": "<array>",
      "toolResults": "<array>",
      "error": "<string>"
    }
  },
  "response": {
    "status": "success",
    "message": "Location sent successfully"
  }
}

{
  "error": "Invalid coordinates or missing number"
}

{
  "error": "Invalid token"
}

{
  "error": "Rate limit exceeded"
}

{
  "error": "Failed to send location"
}

Autorizações

token

string

header

obrigatório

Corpo

application/json

number

string

obrigatório

Número do destinatário (formato internacional)

Exemplo:

"5511999999999"

latitude

number

obrigatório

Latitude (-90 a 90)

Exemplo:

-23.5616

longitude

number

obrigatório

Longitude (-180 a 180)

Exemplo:

-46.6562

name

string

Nome do local

Exemplo:

"MASP"

address

string

Endereço completo do local

Exemplo:

"Av. Paulista, 1578 - Bela Vista"

replyid

string

ID da mensagem para responder

Exemplo:

"3EB0538DA65A59F6D8A251"

mentions

string

Números para mencionar (separados por vírgula)

Exemplo:

"5511999999999,5511888888888"

readchat

boolean

Marca conversa como lida após envio

Exemplo:

true

readmessages

boolean

Marca últimas mensagens recebidas como lidas

Exemplo:

true

delay

integer

Atraso em milissegundos antes do envio, durante o atraso apacerá 'Digitando...'

Exemplo:

1000

forward

boolean

Marca a mensagem como encaminhada no WhatsApp

Exemplo:

true

track_source

string

Origem do rastreamento da mensagem

Exemplo:

"chatwoot"

track_id

string

ID para rastreamento da mensagem (aceita valores duplicados)

Exemplo:

"msg_123456789"

Resposta

Localização enviada com sucesso

Representa uma mensagem trocada no sistema

string<uuid>

ID único interno da mensagem (formato r + 7 caracteres hex aleatórios)

messageid

string

ID original da mensagem no provedor

chatid

string

ID da conversa relacionada

fromMe

boolean

padrão:false

Indica se a mensagem foi enviada pelo usuário

isGroup

boolean

padrão:false

Indica se é uma mensagem de grupo

messageType

enum<string>

Tipo de conteúdo da mensagem

Opções disponíveis:

text,

image,

video,

document,

audio,

location,

button,

list,

reaction

messageTimestamp

integer

padrão:0

Timestamp original da mensagem em milissegundos

edited

string

padrão:""

Histórico de edições da mensagem

quoted

string

padrão:""

ID da mensagem citada/respondida

reaction

string

padrão:""

ID da mensagem reagida

sender

string

padrão:""

ID do remetente da mensagem

senderName

string

padrão:""

Nome exibido do remetente

source

enum<string>

padrão:""

Plataforma de origem da mensagem

Opções disponíveis:

ios,

web,

android

status

enum<string>

padrão:""

Status do ciclo de vida da mensagem

Opções disponíveis:

pending,

sent,

delivered,

read,

failed,

deleted

text

string

padrão:""

Texto original da mensagem

vote

string

padrão:""

Dados de votação de enquete e listas

buttonOrListid

string

padrão:""

ID do botão ou item de lista selecionado

convertOptions

string

padrão:""

Conversão de opções de da mensagem, lista, enquete e botões

fileURL

string<uri>

padrão:""

URL para download de arquivos de mídia

content

string

Conteúdo completo da mensagem em formato JSON

owner

string

padrão:""

Dono da mensagem

track_source

string

padrão:""

Origem do rastreamento da mensagem

track_id

string

padrão:""

ID para rastreamento da mensagem (aceita valores duplicados)

created

string<date-time>

padrão:(strftime('%Y-%m-%d %H:%M:%f', 'now'))

Data de criação no sistema (formato SQLite YYYY-MM-DD HH:MM:SS.FFF)

updated

string<date-time>

padrão:(strftime('%Y-%m-%d %H:%M:%f', 'now'))

Data da última atualização (formato SQLite YYYY-MM-DD HH:MM:SS.FFF)

ai_metadata

object

Metadados do processamento por IA

Show child attributes

response

object

Show child attributes

Instancia

Chatbot Configurações

CRM

Perfil

Enviar Mensagem

Ações na mensagem e Buscar

Grupos e Comunidades

Server-Sent Events (SSE)

Configuração do Agente de IA

Mensagem em massa

Chatbot Trigger

Conhecimento dos Agentes

Funções API dos Agentes

Bloqueios

Etiquetas

Chats

Contatos

Respostas Rápidas

Chamadas

Integração Chatwoot

Enviar localização geográfica

Recursos Específicos

Campos Comuns

Exemplo Básico

Autorizações

Corpo

Resposta