Este documento relaciona a documentação referente à utilização da API Maxbot. A API Maxbot permite integração do Maxbot com sistemas externos como RPs e CRMs. A API permite fazer o download dos dados dos contatos, protocolos, diálogo do protocolo, bem como o disparo de mensagens de texto, imagem, arquivo e áudio.
Para ativar a API Maxbot faça o login em sua conta Maxbot e vá para Configuração/API Maxbot. Clique no botão de ativação. Um token de identificação da conta será gerado e a API será ativada para a sua conta. Caso precise gerar um novo token de identificação, clique no botão Gerar Novo Token. O token informado na tela será o token de identificação de conta que será usado na validação de comunicação com a API Maxbot.
A API (sigla em inglês para Interface de Programação de Aplicativos) é um conjunto de rotinas e padrões de programação para acesso a um aplicativo de software ou plataforma baseado na Web. A plataforma Maxbot oferece uma API REST de comunicação que permite a integração do Maxbot com sistemas externos, possibilitando:
A documentação está organizada de forma a apresentar de maneira sucinta as orientações técnicas necessárias para a integração. Os exemplos operacionais estão disponíveis na linguagem PHP 7.3 que servem de modelo de entendimento de como a integração externa com o Maxbot pode ser feita. Ela deve ser adaptada conforme a necessidade.
Utilize a requisição de situação para verificar a situação atual da API Maxbot para verificação e monitoramento da condição atual da API.
{
"token": "xxxx",
"cmd": "get_status"
}
{
"status": 1,
"msg": "Success",
"data":[{
"created_at": "2020-08-22",
"status": "Active",
"last_execution_at": "2020-08-29 21:21:32",
"last_operation": "Sound Shooting"
}]
}
Este exemplo funcional em PHP 7.3 executa um post para a API e apresenta o retorno na tela para validação. Modifique o código para se adequar às suas necessidades. Para outras linguagens, adapte o código de acordo.
<?php
header('Content-Type: text/html; charset=utf-8');
# Parametros
$_TOKEN = 'xxxxxx';
$_CMD = 'get_status';
# URL
$_URL = 'https://mbr.maxbot.com.br/api/v1.php';
# START
$_TXT = "[POST]:<br/><br/>";
$_TXT .= " API_URL => ".$_URL."<br/>";
$_TXT .= " token => ".$_TOKEN."<br/>";
$_TXT .= " cmd => ".$_CMD."<br/>";
$_TXT .= "<br/>";
$_TXT .= "[retorno]:<br/><br/>";
$_TXT .= "<textarea rows=10 cols=90>";
echo $_TXT;
# Request API
$_REQUEST = array(
"token" => "$_TOKEN",
"cmd" => "$_CMD"
);
$json = json_encode($_REQUEST);
$ch = curl_init($_URL);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $json);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
'Content-Type: application/json',
'Content-Length: ' . strlen($json))
);
$_result = curl_exec($ch);
curl_close($ch);
echo $_result;
echo "</textarea>";
exit;
?>
Utilize a requisição de listagem de segmentações para importar a relação de segmentações cadastradas na conta Maxbot.
{
"token": "xxxx",
"cmd": "get_segmentation"
}
{
"status": 1,
"msg": "Success",
"segmentation": [
{
"id": 1452,
"title": "Negocia\u00e7\u00e3o"
},
{
"id": 2267,
"title": "Proposta Enviada"
}
]
}
Este exemplo funcional em PHP 7.3 executa um post para a API e apresenta o retorno na tela para validação. Modifique o código para se adequar às suas necessidades. Para outras linguagens, adapte o código de acordo.
<?php
header('Content-Type: text/html; charset=utf-8');
# Parametros
$_TOKEN = 'xxxxxx';
$_CMD = 'get_segmentation';
# URL
$_URL = 'https://mbr.maxbot.com.br/api/v1.php';
# START
$_TXT = "[POST]:<br/><br/>";
$_TXT .= " API_URL => ".$_URL."<br/>";
$_TXT .= " token => ".$_TOKEN."<br/>";
$_TXT .= " cmd => ".$_CMD."<br/>";
$_TXT .= "<br/>";
$_TXT .= "[retorno]:<br/><br/>";
$_TXT .= "<textarea rows=10 cols=90>";
echo $_TXT;
# Request API
$_REQUEST = array(
"token" => "$_TOKEN",
"cmd" => "$_CMD"
);
$json = json_encode($_REQUEST);
$ch = curl_init($_URL);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $json);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
'Content-Type: application/json',
'Content-Length: ' . strlen($json))
);
$_result = curl_exec($ch);
curl_close($ch);
echo $_result;
echo "</textarea>";
exit;
?>
Utilize a requisição de listagem de templates para importar a relação de templates cadastrados na conta Maxbot.
{
"token": "xxxx",
"cmd": "get_template"
}
{
"status": 1,
"msg": "Success",
"template": [
{
"id": 1,
"type": "chat",
"title": "Negocia\u00e7\u00e3o",
"for_use": 0
},
{
"id": 2,
"type": "followup",
"title": "Abertura de Protocolo",
"for_use": 1
},
{
"id": 3,
"type": "notice",
"title": "Aviso de Postado nos Correios",
"for_use": 1
}
]
}
Este exemplo funcional em PHP 7.3 executa um post para a API e apresenta o retorno na tela para validação. Modifique o código para se adequar às suas necessidades. Para outras linguagens, adapte o código de acordo.
<?php
header('Content-Type: text/html; charset=utf-8');
# Parametros
$_TOKEN = 'xxxxxx';
$_CMD = 'get_template';
# URL
$_URL = 'https://mbr.maxbot.com.br/api/v1.php';
# START
$_TXT = "[POST]:<br/><br/>";
$_TXT .= " API_URL => ".$_URL."<br/>";
$_TXT .= " token => ".$_TOKEN."<br/>";
$_TXT .= " cmd => ".$_CMD."<br/>";
$_TXT .= "<br/>";
$_TXT .= "[retorno]:<br/><br/>";
$_TXT .= "<textarea rows=10 cols=90>";
echo $_TXT;
# Request API
$_REQUEST = array(
"token" => "$_TOKEN",
"cmd" => "$_CMD"
);
$json = json_encode($_REQUEST);
$ch = curl_init($_URL);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $json);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
'Content-Type: application/json',
'Content-Length: ' . strlen($json))
);
$_result = curl_exec($ch);
curl_close($ch);
echo $_result;
echo "</textarea>";
exit;
?>
Utilize a requisição de listagem de setores de atendimento para importar a relação de setores de atendimento cadastrados na conta Maxbot.
{
"token": "xxxx",
"cmd": "get_service_sector"
}
{
"status": 1,
"msg": "Success",
"service_sector": [
{
"id": 1,
"code": "CO",
"name": "Comercial",
"responsible_name": "Rodrigo Gomide",
"responsible_email": "rodrigo@email.com",
"responsible_whatsapp": "553111116666",
"responsible_mobile_phone": "553111116666",
"responsible_phone_extension": "5454",
"operation_monday_answer": 1,
"operation_monday_shift1": "08:00-12:00",
"operation_monday_shift2": "13:00-18:00",
"operation_tuesday_answer": 1,
"operation_tuesday_shift1": "08:00-12:00",
"operation_tuesday_shift2": "13:00-18:00",
"operation_wednesday_answer": 1,
"operation_wednesday_shift1": "08:00-12:00",
"operation_wednesday_shift2": "13:00-18:00",
"operation_thursday_answer": 1,
"operation_thursday_shift1": "08:00-12:00",
"operation_thursday_shift2": "13:00-18:00",
"operation_friday_answer": 1,
"operation_friday_shift1": "08:00-12:00",
"operation_friday_shift2": "13:00-18:00",
"operation_saturday_answer": 1,
"operation_saturday_shift1": "08:00-12:00",
"operation_saturday_shift2": "13:00-18:00",
"operation_sunday_answer": 1,
"operation_sunday_shift1": "08:00-12:00",
"operation_sunday_shift2": "13:00-18:00",
"allow_service_with_unavailable_attendants": 0
},
{
"id": 2,
"code": "LO",
"name": "Log\u00edstica",
"responsible_name": "Romulo Balga",
"responsible_email": "romulo@email.com",
"responsible_whatsapp": "553122226666",
"responsible_mobile_phone": "553122226666",
"responsible_phone_extension": "5451",
"operation_monday_answer": 1,
"operation_monday_shift1": "08:00-12:00",
"operation_monday_shift2": "13:00-18:00",
"operation_tuesday_answer": 1,
"operation_tuesday_shift1": "08:00-12:00",
"operation_tuesday_shift2": "13:00-18:00",
"operation_wednesday_answer": 1,
"operation_wednesday_shift1": "08:00-12:00",
"operation_wednesday_shift2": "13:00-18:00",
"operation_thursday_answer": 1,
"operation_thursday_shift1": "08:00-12:00",
"operation_thursday_shift2": "13:00-18:00",
"operation_friday_answer": 1,
"operation_friday_shift1": "08:00-12:00",
"operation_friday_shift2": "13:00-18:00",
"operation_saturday_answer": 1,
"operation_saturday_shift1": "08:00-12:00",
"operation_saturday_shift2": "13:00-18:00",
"operation_sunday_answer": 1,
"operation_sunday_shift1": "08:00-12:00",
"operation_sunday_shift2": "13:00-18:00",
"allow_service_with_unavailable_attendants": 1
},
{
"id": 2,
"code": "MA",
"name": "Manuten\u00e7\u00e3o",
"responsible_name": "Dilson Lana",
"responsible_email": "dilson@email.com",
"responsible_whatsapp": "553122227766",
"responsible_mobile_phone": "",
"responsible_phone_extension": "5400",
"operation_monday_answer": 2,
"operation_monday_shift1": "08:00-12:00",
"operation_monday_shift2": "13:00-18:00",
"operation_tuesday_answer": 2,
"operation_tuesday_shift1": "08:00-12:00",
"operation_tuesday_shift2": "13:00-18:00",
"operation_wednesday_answer": 2,
"operation_wednesday_shift1": "08:00-12:00",
"operation_wednesday_shift2": "13:00-18:00",
"operation_thursday_answer": 2,
"operation_thursday_shift1": "08:00-12:00",
"operation_thursday_shift2": "13:00-18:00",
"operation_friday_answer": 2,
"operation_friday_shift1": "08:00-12:00",
"operation_friday_shift2": "13:00-18:00",
"operation_saturday_answer": 2,
"operation_saturday_shift1": "08:00-12:00",
"operation_saturday_shift2": "13:00-18:00",
"operation_sunday_answer": 0,
"operation_sunday_shift1": "08:00-12:00",
"operation_sunday_shift2": "13:00-18:00",
"allow_service_with_unavailable_attendants": 1
}
]
}
Este exemplo funcional em PHP 7.3 executa um post para a API e apresenta o retorno na tela para validação. Modifique o código para se adequar às suas necessidades. Para outras linguagens, adapte o código de acordo.
<?php
header('Content-Type: text/html; charset=utf-8');
# Parametros
$_TOKEN = 'xxxxxx';
$_CMD = 'get_service_sector';
# URL
$_URL = 'https://mbr.maxbot.com.br/api/v1.php';
# START
$_TXT = "[POST]:<br/><br/>";
$_TXT .= " API_URL => ".$_URL."<br/>";
$_TXT .= " token => ".$_TOKEN."<br/>";
$_TXT .= " cmd => ".$_CMD."<br/>";
$_TXT .= "<br/>";
$_TXT .= "[retorno]:<br/><br/>";
$_TXT .= "<textarea rows=10 cols=90>";
echo $_TXT;
# Request API
$_REQUEST = array(
"token" => "$_TOKEN",
"cmd" => "$_CMD"
);
$json = json_encode($_REQUEST);
$ch = curl_init($_URL);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $json);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
'Content-Type: application/json',
'Content-Length: ' . strlen($json))
);
$_result = curl_exec($ch);
curl_close($ch);
echo $_result;
echo "</textarea>";
exit;
?>
Utilize a requisição de listagem de atendentes para importar a relação de atendentes cadastrados na conta Maxbot.
{
"token": "xxxx",
"cmd": "get_attendant"
}
{
"status": 1,
"msg": "Success",
"attendant": [
{
"id": 1,
"service_sector_id": [1],
"name": "Pedro Silva",
"status": 1
},
{
"id": 2,
"service_sector_id": [2,3],
"name": "Jos\u00e9 Nogueira",
"status": 0
},
{
"id": 3,
"service_sector_id": [1,3,8,29],
"name": "Ant\u00f4nio Prado",
"status": 1
}
]
}
Este exemplo funcional em PHP 7.3 executa um post para a API e apresenta o retorno na tela para validação. Modifique o código para se adequar às suas necessidades. Para outras linguagens, adapte o código de acordo.
<?php
header('Content-Type: text/html; charset=utf-8');
# Parametros
$_TOKEN = 'xxxxxx';
$_CMD = 'get_attendant';
# URL
$_URL = 'https://mbr.maxbot.com.br/api/v1.php';
# START
$_TXT = "[POST]:<br/><br/>";
$_TXT .= " API_URL => ".$_URL."<br/>";
$_TXT .= " token => ".$_TOKEN."<br/>";
$_TXT .= " cmd => ".$_CMD."<br/>";
$_TXT .= "<br/>";
$_TXT .= "[retorno]:<br/><br/>";
$_TXT .= "<textarea rows=10 cols=90>";
echo $_TXT;
# Request API
$_REQUEST = array(
"token" => "$_TOKEN",
"cmd" => "$_CMD"
);
$json = json_encode($_REQUEST);
$ch = curl_init($_URL);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $json);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
'Content-Type: application/json',
'Content-Length: ' . strlen($json))
);
$_result = curl_exec($ch);
curl_close($ch);
echo $_result;
echo "</textarea>";
exit;
?>
Utilize a requisição de dados do contato para importar a ficha de cadastro do contato. Todos os dados existentes na ficha cadastral serão retornados. Desta forma, um sistema externo (RP, CRM, etc) poderá importar os contatos novos que entraram no atendimento, bem como obter os dados mais atuais de contatos já existentes.
{
"token": "xxxx",
"cmd": "get_contact",
"date_start": "2020-08-01",
"date_stop": "2020-08-01",
"whatsapp": "5511999998888",
"mobile_phone": "5511999998888",
"email": "fulano@mail.com",
"external_id": "1234"
}
{
"status": 1,
"msg": "Success",
"data": [
{
"id": "1",
"cad_date": "2020-06-08 08:07:16",
"segmentation": [],
"tag": "THER",
"name": "Rodrigo",
"surname": "Funda\u00e7\u00e3o Ther",
"gender": "M",
"birth": "1974-10-22",
"age": "46",
"br_person_type": "J",
"br_cpf": "11122233344",
"br_cnpj": "11222333000144",
"company": "Ther Sistemas Ltda",
"email": "rodrigo@maxbot.com.br",
"whatsapp": "5531911112222",
"mobile_phone": "5531922223333",
"phone": "3132324455",
"country": "BR",
"state": "MG",
"city": "Vi\u00e7osa",
"profession": "",
"external_id": "5678",
"avatar_url": "",
"obs": "",
"in_attendance": "0",
"current_protocol": "",
"current_attendant": ""
},
{
"id": "2",
"cad_date": "2020-06-18 19:10:42",
"segmentation": [],
"tag": "",
"name": "Dilson",
"surname": "Lana",
"gender": "M",
"birth": "",
"age": "",
"br_person_type": "F",
"br_cpf": "",
"br_cnpj": "",
"company": "",
"email": "",
"whatsapp": "5531911112222",
"mobile_phone": "5531922223333",
"phone": "",
"country": "BR",
"state": "SP",
"city": "Campinas",
"profession": "",
"external_id": "",
"avatar_url": "",
"obs": "Cliente VIP",
"in_attendance": "1",
"current_protocol": "2345",
"current_attendant": "Keli Marchi"
},
{
"id": "3",
"cad_date": "2020-06-19 19:05:07",
"segmentation": ["Negocia\u00e7\u00e3o", "Proposta Enviada"],
"tag": "Atd Romulo",
"name": "Keli",
"surname": "Marchi",
"gender": "F",
"birth": "1990-06-15",
"age": "30",
"br_person_type": "F",
"br_cpf": "11122233300",
"br_cnpj": "",
"company": "",
"email": "keli@email.com",
"whatsapp": "5531911116666",
"mobile_phone": "5531911116666",
"phone": "",
"country": "BR",
"state": "RJ",
"city": "Rio de Janeiro",
"profession": "Ci\u00eancias Cont\u00e1beis",
"external_id": "keli-09",
"avatar_url": "https:\/\/maxbot.com.br\/anexos_docs\/f434cd6b295984e3a0c05d8d67ae173d_small.jpg",
"obs": "ENVIAR PROPOSTA COMERCIAL NA SEGUNDA",
"in_attendance": "0",
"current_protocol": "",
"current_attendant": ""
}
]
}
Este exemplo funcional em PHP 7.3 executa um post para a API e apresenta o retorno na tela para validação. Modifique o código para se adequar às suas necessidades. Para outras linguagens, adapte o código de acordo.
<?php
header('Content-Type: text/html; charset=utf-8');
# Parametros
$_TOKEN = 'xxxxxx';
$_CMD = 'get_contact';
$_DATA_INI = '2020-01-01';
$_DATA_FIM = '2020-08-25';
# URL
$_URL = 'https://mbr.maxbot.com.br/api/v1.php';
# START
$_TXT = "[POST]:<br/><br/>";
$_TXT .= " API_URL => ".$_URL."<br/>";
$_TXT .= " token => ".$_TOKEN."<br/>";
$_TXT .= " cmd => ".$_CMD."<br/>";
$_TXT .= "date_start => ".$_DATA_INI."<br/>";
$_TXT .= " date_stop => ".$_DATA_FIM."<br/>";
$_TXT .= "<br/>";
$_TXT .= "[retorno]:<br/><br/>";
$_TXT .= "<textarea rows=10 cols=90>";
echo $_TXT;
# Request API
$_REQUEST = array(
"token" => "$_TOKEN",
"cmd" => "$_CMD",
"date_start" => "$_DATA_INI",
"date_stop" => "$_DATA_FIM"
);
$json = json_encode($_REQUEST);
$ch = curl_init($_URL);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $json);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
'Content-Type: application/json',
'Content-Length: ' . strlen($json))
);
$_result = curl_exec($ch);
curl_close($ch);
echo $_result;
echo "</textarea>";
exit;
?>
Utilize a requisição de dados do protocolo para importar as protocolos concluídos em um determinado período. Todos os dados existentes na ficha do protocolo serão retornados. Desta forma, um sistema externo (RP, CRM, etc) poderá importar os dados do atendimento. A requisição retorna todos os dados do protocolo, bem como todo o diálogo trocado pelo atendente com o contato. Obs.: Retorna dados apenas de protocolos concluídos!
{
"token": "xxxx",
"cmd": "get_prot",
"date_focus": 0,
"date_start": "2020-08-17",
"date_stop": "2020-08-19"
}
{
"status": 1,
"msg": "Success",
"data": [
{
"id": "143",
"protocol_number": "143",
"service_sector": "Suporte T\u00e9cnico",
"attendant_name": "Rodrigo Gomide",
"contact_name": "Roberto Fulano",
"contact_whatsapp": "553195551111",
"contact_email": "",
"created_date": "2020-08-31",
"started_date": "2020-08-31 14:33:39",
"concluded_date": "2020-08-31 14:37:52",
"duration": "00:00:04",
"obs": "Atendimento encerrado pelo atendente.",
"notes": [
{
"id": "11",
"date": "2020-08-31 14:36:47",
"attendant_name": "Rodrigo Gomide",
"note": "Cliente pede urg\u00eancia, pois precisa da internet para realizar uma live. Pedir urg\u00eancia \u00e0 equipe t\u00e9cnica."
},
{
"id": "10",
"date": "2020-08-31 14:34:25",
"attendant_name": "Rodrigo Gomide",
"note": "Cliente reclama que est\u00e1 sem acesso \u00e0 internet. Solicita suporte t\u00e9cnico para reestabelecimento do servi\u00e7o."
}
],
"dialog": [
{
"id": "769",
"date": "2020-08-31",
"internal_communication": "0",
"flux": "reply",
"type": "T",
"sent_by": "Roberto Fulano",
"received_by": "Rodrigo Gomide",
"msg_id": "3EB03C160CBC1BC9B9D9",
"msg_text": "[Abertura de Protocolo #0000000143]\n\n[Orienta\u00e7\u00e3o]:\n\n1. Solicitar ao contato:\n- Nome\n- Sobrenome\n- Email\n\n2. Segmentar a ficha do contato como prospect\n3. Atualizar a ficha do contato com o ID Externo\n\nN\u00e3o esque\u00e7a de sorrir hehehe\n",
"msg_sound": "",
"msg_image": "",
"msg_file": "",
"msg_location_preview": "",
"msg_location_lat": "",
"msg_location_lng": "",
"quoted_msg_id": "",
"quoted_msg_text": "",
"quoted_msg_sound": "",
"quoted_msg_image": "",
"quoted_msg_file": "",
"quoted_msg_location_preview": "",
"quoted_msg_location_lat": "",
"quoted_msg_location_lng": ""
},
{
"id": "770",
"date": "2020-08-31",
"internal_communication": "0",
"flux": "sent",
"type": "T",
"sent_by": "Rodrigo Gomide",
"received_by": "Roberto Fulano",
"msg_id": "",
"msg_text": "Ol\u00e1 Roberto, meu nome \u00e9 Rodrigo, como posso ajudar?",
"msg_sound": "",
"msg_image": "",
"msg_file": "",
"msg_location_preview": "",
"msg_location_lat": "",
"msg_location_lng": "",
"quoted_msg_id": "",
"quoted_msg_text": "",
"quoted_msg_sound": "",
"quoted_msg_image": "",
"quoted_msg_file": "",
"quoted_msg_location_preview": "",
"quoted_msg_location_lat": "",
"quoted_msg_location_lng": ""
},
{
"id": "771",
"date": "2020-08-31",
"internal_communication": "0",
"flux": "reply",
"type": "T",
"sent_by": "Roberto Fulano",
"received_by": "Rodrigo Gomide",
"msg_id": "3EB0F5D5A370A2A28F76",
"msg_text": "Ol\u00e1, estou sem acesso \u00e0 internet. Preciso de suporte t\u00e9cnico.",
"msg_sound": "",
"msg_image": "",
"msg_file": "",
"msg_location_preview": "",
"msg_location_lat": "",
"msg_location_lng": "",
"quoted_msg_id": "",
"quoted_msg_text": "",
"quoted_msg_sound": "",
"quoted_msg_image": "",
"quoted_msg_file": "",
"quoted_msg_location_preview": "",
"quoted_msg_location_lat": "",
"quoted_msg_location_lng": ""
},
{
"id": "772",
"date": "2020-08-31",
"internal_communication": "0",
"flux": "sent",
"type": "T",
"sent_by": "Rodrigo Gomide",
"received_by": "Roberto Fulano",
"msg_id": "",
"msg_text": "Ok. Registrei a sua reclama\u00e7\u00e3o. Vou solicitar \u00e0 equipe t\u00e9cnica que veja o que est\u00e1 ocorrendo. Tempo de resolu\u00e7\u00e3o do problema \u00e9 de cerca de 2 horas. Posso ajudar em algo mais?",
"msg_sound": "",
"msg_image": "",
"msg_file": "",
"msg_location_preview": "",
"msg_location_lat": "",
"msg_location_lng": "",
"quoted_msg_id": "",
"quoted_msg_text": "",
"quoted_msg_sound": "",
"quoted_msg_image": "",
"quoted_msg_file": "",
"quoted_msg_location_preview": "",
"quoted_msg_location_lat": "",
"quoted_msg_location_lng": ""
},
{
"id": "773",
"date": "2020-08-31",
"internal_communication": "0",
"flux": "reply",
"type": "T",
"sent_by": "Roberto Fulano",
"received_by": "Rodrigo Gomide",
"msg_id": "3EB09B22C2C2BADE917F",
"msg_text": "Teria como resolver mais r\u00e1pido? Preciso da internet para fazer uma live pelo YouTube.",
"msg_sound": "",
"msg_image": "",
"msg_file": "",
"msg_location_preview": "",
"msg_location_lat": "",
"msg_location_lng": "",
"quoted_msg_id": "",
"quoted_msg_text": "",
"quoted_msg_sound": "",
"quoted_msg_image": "",
"quoted_msg_file": "",
"quoted_msg_location_preview": "",
"quoted_msg_location_lat": "",
"quoted_msg_location_lng": ""
},
{
"id": "774",
"date": "2020-08-31",
"internal_communication": "0",
"flux": "sent",
"type": "T",
"sent_by": "Rodrigo Gomide",
"received_by": "Roberto Fulano",
"msg_id": "",
"msg_text": "Vou pedir urg\u00eancia para a resolu\u00e7\u00e3o do seu caso. Posso ajudar em algo mais?",
"msg_sound": "",
"msg_image": "",
"msg_file": "",
"msg_location_preview": "",
"msg_location_lat": "",
"msg_location_lng": "",
"quoted_msg_id": "",
"quoted_msg_text": "",
"quoted_msg_sound": "",
"quoted_msg_image": "",
"quoted_msg_file": "",
"quoted_msg_location_preview": "",
"quoted_msg_location_lat": "",
"quoted_msg_location_lng": ""
},
{
"id": "775",
"date": "2020-08-31",
"internal_communication": "0",
"flux": "reply",
"type": "T",
"sent_by": "Roberto Fulano",
"received_by": "Rodrigo Gomide",
"msg_id": "3EB0A1C5728C56BBA05E",
"msg_text": "N\u00e3o, seria somente isso mesmo. Agrade\u00e7o.",
"msg_sound": "",
"msg_image": "",
"msg_file": "",
"msg_location_preview": "",
"msg_location_lat": "",
"msg_location_lng": "",
"quoted_msg_id": "",
"quoted_msg_text": "",
"quoted_msg_sound": "",
"quoted_msg_image": "",
"quoted_msg_file": "",
"quoted_msg_location_preview": "",
"quoted_msg_location_lat": "",
"quoted_msg_location_lng": ""
},
{
"id": "776",
"date": "2020-08-31",
"internal_communication": "0",
"flux": "sent",
"type": "T",
"sent_by": "Rodrigo Gomide",
"received_by": "Roberto Fulano",
"msg_id": "",
"msg_text": "Perfeitamente. Chame sempre que precisar.",
"msg_sound": "",
"msg_image": "",
"msg_file": "",
"msg_location_preview": "",
"msg_location_lat": "",
"msg_location_lng": "",
"quoted_msg_id": "",
"quoted_msg_text": "",
"quoted_msg_sound": "",
"quoted_msg_image": "",
"quoted_msg_file": "",
"quoted_msg_location_preview": "",
"quoted_msg_location_lat": "",
"quoted_msg_location_lng": ""
}
]
}
]
}
Este exemplo funcional em PHP 7.3 executa um post para a API e apresenta o retorno na tela para validação. Modifique o código para se adequar às suas necessidades. Para outras linguagens, adapte o código de acordo.
<?php
header('Content-Type: text/html; charset=utf-8');
# Parametros
$_TOKEN = 'xxxxxx';
$_CMD = 'get_prot';
$_DATA_INI = '2020-08-31';
$_DATA_FIM = '2020-08-31';
# URL
$_URL = 'https://mbr.maxbot.com.br/api/v1.php';
# START
$_TXT = "[POST]:<br/><br/>";
$_TXT .= " API_URL => ".$_URL."<br/>";
$_TXT .= " token => ".$_TOKEN."<br/>";
$_TXT .= " cmd => ".$_CMD."<br/>";
$_TXT .= "date_start => ".$_DATA_INI."<br/>";
$_TXT .= " date_stop => ".$_DATA_FIM."<br/>";
$_TXT .= "<br/>";
$_TXT .= "[retorno]:<br/><br/>";
$_TXT .= "<textarea rows=10 cols=90>";
echo $_TXT;
# Request API
$_REQUEST = array(
"token" => "$_TOKEN",
"cmd" => "$_CMD",
"date_start" => "$_DATA_INI",
"date_stop" => "$_DATA_FIM"
);
$json = json_encode($_REQUEST);
$ch = curl_init($_URL);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $json);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
'Content-Type: application/json',
'Content-Length: ' . strlen($json))
);
$_result = curl_exec($ch);
curl_close($ch);
echo $_result;
echo "</textarea>";
exit;
?>
Utilize a requisição de criação de ficha de contato para criar um novo contato no Maxbot.
{
"token": "xxxx",
"cmd": "put_contact",
"segmentation": ["Negocia\u00e7\u00e3o", "Proposta Enviada"],
"tag": "VIP",
"name": "Jose",
"surname": "Silva",
"gender": "M",
"birth": "1974-06-15",
"br_person_type": "J",
"br_cpf": "11122233300",
"br_cnpj": "00111222000133",
"company": "Empresa Minha Ltda",
"email": "jose@email.com",
"whatsapp": "5531911116666",
"mobile_phone": "5531911116666",
"phone": "553155551122",
"country": "BR",
"state": "MG",
"city": "Belo Horizonte",
"profession": "ESPORTE",
"external_id": "667811",
"avatar_url": "https:\/\/www.meusite.com.br\/foto.jpg",
"obs": "Enviar proposta comercial na segunda"
}
{
"status": 1,
"msg": "Success",
"contact_id": 1234
}
Este exemplo funcional em PHP 7.3 executa um post para a API e apresenta o retorno na tela para validação. Modifique o código para se adequar às suas necessidades. Para outras linguagens, adapte o código de acordo.
<?php
header('Content-Type: text/html; charset=utf-8');
# Parametros
$_TOKEN = 'xxxxxx';
$_CMD = 'put_contact';
$_SEG_LIST = 'Negociação,Proposta Enviada';
$_TAG = 'VIP';
$_NOME = 'Jose';
$_SOBRENOME = 'Silva';
$_SEXO = 'M';
$_NASC = '1974-06-15';
$_PESSOA = 'J';
$_CPF = '87348769527';
$_CNPJ = '64420582000148';
$_EMPRESA = 'Empresa Minha Ltda';
$_EMAIL = 'jose@email.com';
$_WHATSAPP = '5531911116666';
$_CELULAR = '5531911116666';
$_FIXO = '553155551122';
$_PAIS = 'BR';
$_ESTADO = 'MG';
$_CIDADE = 'Belo Horizonte';
$_PROFISSAO = 'ESPORTE';
$_IDEXTERNO = '667811';
$_AVATAR_URL = 'https://www.meusite.com.br/foto.jpg';
$_OBS = 'Enviar proposta comercial na segunda';
# URL
$_URL = 'https://mbr.maxbot.com.br/api/v1.php';
# START
$_TXT = "[POST]:<br/><br/>";
$_TXT .= " API_URL => ".$_URL."<br/>";
$_TXT .= " token => ".$_TOKEN."<br/>";
$_TXT .= " cmd => ".$_CMD."<br/>";
$_TXT .= " segmentation => ".$_SEG_LIST."<br/>";
$_TXT .= " tag => ".$_TAG."<br/>";
$_TXT .= " name => ".$_NOME."<br/>";
$_TXT .= " surname => ".$_SOBRENOME."<br/>";
$_TXT .= " gender => ".$_SEXO."<br/>";
$_TXT .= " birth => ".$_NASC."<br/>";
$_TXT .= " br_person_type => ".$_PESSOA."<br/>";
$_TXT .= " br_cpf => ".$_CPF."<br/>";
$_TXT .= " br_cnpj => ".$_CNPJ."<br/>";
$_TXT .= " company => ".$_EMPRESA."<br/>";
$_TXT .= " email => ".$_EMAIL."<br/>";
$_TXT .= " whatsapp => ".$_WHATSAPP."<br/>";
$_TXT .= " mobile_phone => ".$_CELULAR."<br/>";
$_TXT .= " phone => ".$_FIXO."<br/>";
$_TXT .= " country => ".$_PAIS."<br/>";
$_TXT .= " state => ".$_ESTADO."<br/>";
$_TXT .= " city => ".$_CIDADE."<br/>";
$_TXT .= " profession => ".$_PROFISSAO."<br/>";
$_TXT .= " external_id => ".$_IDEXTERNO."<br/>";
$_TXT .= " avatar_url => ".$_AVATAR_URL."<br/>";
$_TXT .= " obs => ".$_OBS."<br/>";
$_TXT .= "<br/>";
$_TXT .= "[retorno]:<br/><br/>";
$_TXT .= "<textarea rows=10 cols=90>";
echo $_TXT;
# Request API
$_REQUEST = array(
"token" => "$_TOKEN",
"cmd" => "$_CMD",
"segmentation" => "$_SEG_LIST",
"tag" => "$_TAG",
"name" => "$_NOME",
"surname" => "$_SOBRENOME",
"gender" => "$_SEXO",
"birth" => "$_NASC",
"br_person_type" => "$_PESSOA",
"br_cpf" => "$_CPF",
"br_cnpj" => "$_CNPJ",
"company" => "$_EMPRESA",
"email" => "$_EMAIL",
"whatsapp" => "$_WHATSAPP",
"mobile_phone" => "$_CELULAR",
"phone" => "$_FIXO",
"country" => "$_PAIS",
"state" => "$_ESTADO",
"city" => "$_CIDADE",
"profession" => "$_PROFISSAO",
"external_id" => "$_IDEXTERNO",
"avatar_url" => "$_AVATAR_URL",
"obs" => "$_OBS"
);
$json = json_encode($_REQUEST);
$ch = curl_init($_URL);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $json);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
'Content-Type: application/json',
'Content-Length: ' . strlen($json))
);
$_result = curl_exec($ch);
curl_close($ch);
echo $_result;
echo "</textarea>";
exit;
?>
Utilize a requisição de atualização de dados de contato atualizar dados de ficha de um contato existente.
{
"token": "xxxx",
"cmd": "set_contact",
"for_contact_id": "1234",
"segmentation": ["Negocia\u00e7\u00e3o", "Proposta Enviada"],
"tag": "VIP",
"name": "Jose",
"surname": "Silva",
"gender": "M",
"birth": "1974-06-15",
"br_person_type": "J",
"br_cpf": "11122233300",
"br_cnpj": "00111222000133",
"company": "Empresa Minha Ltda",
"email": "jose@email.com",
"whatsapp": "5531911116666",
"mobile_phone": "5531911116666",
"phone": "553155551122",
"country": "BR",
"state": "MG",
"city": "Belo Horizonte",
"profession": "ESPORTE",
"external_id": "667811",
"avatar_url": "https:\/\/www.meusite.com.br\/foto.jpg",
"obs": "Enviar proposta comercial na segunda"
}
{
"status": 1,
"msg": "Success"
}
Este exemplo funcional em PHP 7.3 executa um post para a API e apresenta o retorno na tela para validação. Modifique o código para se adequar às suas necessidades. Para outras linguagens, adapte o código de acordo.
<?php
header('Content-Type: text/html; charset=utf-8');
# Parametros
$_TOKEN = 'xxxxxx';
$_CMD = 'set_contact';
$_CONTATO_ID = '12345';
$_SEG_LIST = 'Negociação,Proposta Enviada';
$_TAG = 'VIP';
$_NOME = 'Jose';
$_SOBRENOME = 'Silva';
$_SEXO = 'M';
$_NASC = '1974-06-15';
$_PESSOA = 'J';
$_CPF = '87348769527';
$_CNPJ = '64420582000148';
$_EMPRESA = 'Empresa Minha Ltda';
$_EMAIL = 'jose@email.com';
$_WHATSAPP = '5531911116666';
$_CELULAR = '5531911116666';
$_FIXO = '553155551122';
$_PAIS = 'BR';
$_ESTADO = 'MG';
$_CIDADE = 'Belo Horizonte';
$_PROFISSAO = 'ESPORTE';
$_IDEXTERNO = '667811';
$_AVATAR_URL = 'https://www.meusite.com.br/foto.jpg';
$_OBS = 'Enviar proposta comercial na segunda';
# URL
$_URL = 'https://mbr.maxbot.com.br/api/v1.php';
# START
$_TXT = "[POST]:<br/><br/>";
$_TXT .= " API_URL => ".$_URL."<br/>";
$_TXT .= " token => ".$_TOKEN."<br/>";
$_TXT .= " cmd => ".$_CMD."<br/>";
$_TXT .= " for_contact_id => ".$_CONTATO_ID."<br/>";
$_TXT .= " segmentation => ".$_SEG_LIST."<br/>";
$_TXT .= " tag => ".$_TAG."<br/>";
$_TXT .= " name => ".$_NOME."<br/>";
$_TXT .= " surname => ".$_SOBRENOME."<br/>";
$_TXT .= " gender => ".$_SEXO."<br/>";
$_TXT .= " birth => ".$_NASC."<br/>";
$_TXT .= " br_person_type => ".$_PESSOA."<br/>";
$_TXT .= " br_cpf => ".$_CPF."<br/>";
$_TXT .= " br_cnpj => ".$_CNPJ."<br/>";
$_TXT .= " company => ".$_EMPRESA."<br/>";
$_TXT .= " email => ".$_EMAIL."<br/>";
$_TXT .= " whatsapp => ".$_WHATSAPP."<br/>";
$_TXT .= " mobile_phone => ".$_CELULAR."<br/>";
$_TXT .= " phone => ".$_FIXO."<br/>";
$_TXT .= " country => ".$_PAIS."<br/>";
$_TXT .= " state => ".$_ESTADO."<br/>";
$_TXT .= " city => ".$_CIDADE."<br/>";
$_TXT .= " profession => ".$_PROFISSAO."<br/>";
$_TXT .= " external_id => ".$_IDEXTERNO."<br/>";
$_TXT .= " avatar_url => ".$_AVATAR_URL."<br/>";
$_TXT .= " obs => ".$_OBS."<br/>";
$_TXT .= "<br/>";
$_TXT .= "[retorno]:<br/><br/>";
$_TXT .= "<textarea rows=10 cols=90>";
echo $_TXT;
# Request API
$_REQUEST = array(
"token" => "$_TOKEN",
"cmd" => "$_CMD",
"for_contact_id" => "$_CONTATO_ID",
"segmentation" => "$_SEG_LIST",
"tag" => "$_TAG",
"name" => "$_NOME",
"surname" => "$_SOBRENOME",
"gender" => "$_SEXO",
"birth" => "$_NASC",
"br_person_type" => "$_PESSOA",
"br_cpf" => "$_CPF",
"br_cnpj" => "$_CNPJ",
"company" => "$_EMPRESA",
"email" => "$_EMAIL",
"whatsapp" => "$_WHATSAPP",
"mobile_phone" => "$_CELULAR",
"phone" => "$_FIXO",
"country" => "$_PAIS",
"state" => "$_ESTADO",
"city" => "$_CIDADE",
"profession" => "$_PROFISSAO",
"external_id" => "$_IDEXTERNO",
"avatar_url" => "$_AVATAR_URL",
"obs" => "$_OBS"
);
$json = json_encode($_REQUEST);
$ch = curl_init($_URL);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $json);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
'Content-Type: application/json',
'Content-Length: ' . strlen($json))
);
$_result = curl_exec($ch);
curl_close($ch);
echo $_result;
echo "</textarea>";
exit;
?>
Utilize a requisição de abertura de protocolo de follow up para enviar um template de follow up seguido da abertura automática de um protocolo de atendimento para um contato. Você pode disparar templates para qualquer contato previamente existente na sua base de contatos.
{
"token": "xxxx",
"cmd": "open_followup",
"contact_id": 1234,
"template_id": 1234,
"sector_id": 1234,
"attendant_id": 0,
"scheduled": 1,
"date_time": "2020-12-01 13:00:00"
}
{
"status": 1,
"msg": "Success"
}
Este exemplo funcional em PHP 7.3 executa um post para a API e apresenta o retorno na tela para validação. Modifique o código para se adequar às suas necessidades. Para outras linguagens, adapte o código de acordo.
<?php
header('Content-Type: text/html; charset=utf-8');
# Parametros
$_TOKEN = 'xxxxxx';
$_CMD = 'open_followup';
$_CT_ID = '1234';
$_TP_ID = '1234';
$_ST_ID = '1234';
$_AT_ID = '0';
$_SCHEDULED = '0';
$_DATE_TIME = '2020-12-01 08:30:00';
# URL
$_URL = 'https://mbr.maxbot.com.br/api/v1.php';
# START
$_TXT = "[POST]:<br/><br/>";
$_TXT .= " API_URL => ".$_URL."<br/>";
$_TXT .= " token => ".$_TOKEN."<br/>";
$_TXT .= " cmd => ".$_CMD."<br/>";
$_TXT .= " contact_id => ".$_CT_ID."<br/>";
$_TXT .= " template_id => ".$_TP_ID."<br/>";
$_TXT .= " sector_id => ".$_ST_ID."<br/>";
$_TXT .= " attendant_id => ".$_AT_ID."<br/>";
$_TXT .= " scheduled => ".$_SCHEDULED."<br/>";
$_TXT .= " date_time => ".$_DATE_TIME."<br/>";
$_TXT .= "<br/>";
$_TXT .= "[retorno]:<br/><br/>";
$_TXT .= "<textarea rows=10 cols=90>";
echo $_TXT;
# Request API
$_REQUEST = array(
"token" => "$_TOKEN",
"cmd" => "$_CMD",
"contact_id" => "$_CT_ID",
"template_id" => "$_TP_ID",
"sector_id" => "$_ST_ID",
"attendant_id" => "$_AT_ID",
"scheduled" => "$_SCHEDULED",
"date_time" => "$_DATE_TIME"
);
$json = json_encode($_REQUEST);
$ch = curl_init($_URL);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $json);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
'Content-Type: application/json',
'Content-Length: ' . strlen($json))
);
$_result = curl_exec($ch);
curl_close($ch);
echo $_result;
echo "</textarea>";
exit;
?>
Utilize a requisição de disparo de mensagem de texto para enviar uma mensagem de texto para um contato existente no Maxbot. Você pode disparar mensagens para qualquer contato previamente existente na sua base de contatos. O disparo é feito conforme as seguintes condições:
{
"token": "xxxx",
"cmd": "send_text",
"ct_whatsapp": "553191112222",
"ct_external_id": "1234",
"ct_br_cpf": "11122233344",
"msg": "Mensagem de Texto"
}
{
"status": 1,
"msg": "Success"
}
Este exemplo funcional em PHP 7.3 executa um post para a API e apresenta o retorno na tela para validação. Modifique o código para se adequar às suas necessidades. Para outras linguagens, adapte o código de acordo.
<?php
header('Content-Type: text/html; charset=utf-8');
# Parametros
$_TOKEN = 'xxxxxx';
$_CMD = 'send_text';
$_CT_WHATSAPP = '553196668586';
$_CT_CPF = '03104925640';
$_CT_IDEXTERNO = '1234';
$_MSG = "teste de disparo 001!";//\nEmojis: [EMOJI1] [EMOJI2] [EMOJI3] [EMOJI4] [EMOJI5] [EMOJI6] [EMOJI7] [EMOJI8] [EMOJI9] [EMOJI10] ";
# URL
$_URL = 'https://mbr.maxbot.com.br/api/v1.php';
# START
$_TXT = "[POST]:<br/><br/>";
$_TXT .= " API_URL => ".$_URL."<br/>";
$_TXT .= " token => ".$_TOKEN."<br/>";
$_TXT .= " cmd => ".$_CMD."<br/>";
$_TXT .= " ct_whatsapp => ".$_CT_WHATSAPP."<br/>";
$_TXT .= " ct_br_cpf => ".$_CT_CPF."<br/>";
$_TXT .= "ct_external_id => ".$_CT_IDEXTERNO."<br/>";
$_TXT .= " msg => ".$_MSG."<br/>";
$_TXT .= "<br/>";
$_TXT .= "[retorno]:<br/><br/>";
$_TXT .= "<textarea rows=10 cols=90>";
echo $_TXT;
# Request API
$_REQUEST = array(
"token" => "$_TOKEN",
"cmd" => "$_CMD",
"ct_whatsapp" => "$_CT_WHATSAPP",
"ct_br_cpf" => "$_CT_CPF",
"ct_external_id" => "$_CT_IDEXTERNO",
"msg" => "$_MSG"
);
$json = json_encode($_REQUEST);
$ch = curl_init($_URL);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $json);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
'Content-Type: application/json',
'Content-Length: ' . strlen($json))
);
$_result = curl_exec($ch);
curl_close($ch);
echo $_result;
echo "</textarea>";
exit;
?>
Utilize a requisição de disparo de imagem para enviar uma imagem (jpg, jpeg, png ou gif) para um contato existente no Maxbot. Você pode disparar imagens para qualquer contato previamente existente na sua base de contatos. O disparo é feito conforme as seguintes condições:
{
"token": "xxxx",
"cmd": "send_image",
"ct_whatsapp": "553191112222",
"ct_external_id": "1234",
"ct_br_cpf": "11122233344",
"image_url": "https://www.meusite.com.br/foto.png",
"image_extension": "png"
}
{
"status": 1,
"msg": "Success"
}
Este exemplo funcional em PHP 7.3 executa um post para a API e apresenta o retorno na tela para validação. Modifique o código para se adequar às suas necessidades. Para outras linguagens, adapte o código de acordo.
<?php
header('Content-Type: text/html; charset=utf-8');
# Parametros
$_TOKEN = 'xxxxxx';
$_CMD = 'send_text';
$_CT_WHATSAPP = '553196668586';
$_CT_CPF = '03104925640';
$_CT_IDEXTERNO = '1234';
$_IMG_URL = 'https://www.meusite.com.br/foto.png';
$_IMG_EXT = 'png';
# URL
$_URL = 'https://mbr.maxbot.com.br/api/v1.php';
# START
$_TXT = "[POST]:<br/><br/>";
$_TXT .= " API_URL => ".$_URL."<br/>";
$_TXT .= " token => ".$_TOKEN."<br/>";
$_TXT .= " cmd => ".$_CMD."<br/>";
$_TXT .= " ct_whatsapp => ".$_CT_WHATSAPP."<br/>";
$_TXT .= " ct_br_cpf => ".$_CT_CPF."<br/>";
$_TXT .= " ct_external_id => ".$_CT_IDEXTERNO."<br/>";
$_TXT .= " image_url => ".$_IMG_URL."<br/>";
$_TXT .= "image_extension => ".$_IMG_EXT."<br/>";
$_TXT .= "<br/>";
$_TXT .= "[retorno]:<br/><br/>";
$_TXT .= "<textarea rows=10 cols=90>";
echo $_TXT;
# Request API
$_REQUEST = array(
"token" => "$_TOKEN",
"cmd" => "$_CMD",
"ct_whatsapp" => "$_CT_WHATSAPP",
"ct_br_cpf" => "$_CT_CPF",
"ct_external_id" => "$_CT_IDEXTERNO",
"image_url" => "$_IMG_URL",
"image_extension" => "$_IMG_EXT"
);
$json = json_encode($_REQUEST);
$ch = curl_init($_URL);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $json);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
'Content-Type: application/json',
'Content-Length: ' . strlen($json))
);
$_result = curl_exec($ch);
curl_close($ch);
echo $_result;
echo "</textarea>";
exit;
?>
Utilize a requisição de disparo de documento para enviar um documento (pdf, doc, docx, xls, xlsx, ppt, pptx ou pps) para um contato existente no Maxbot. Você pode disparar documentos para qualquer contato previamente existente na sua base de contatos. O disparo é feito conforme as seguintes condições:
{
"token": "xxxx",
"cmd": "send_file",
"ct_whatsapp": "553191112222",
"ct_external_id": "1234",
"ct_br_cpf": "11122233344",
"file_url": "https://www.meusite.com.br/teste.pdf",
"file_extension": "pdf"
}
{
"status": 1,
"msg": "Success"
}
Este exemplo funcional em PHP 7.3 executa um post para a API e apresenta o retorno na tela para validação. Modifique o código para se adequar às suas necessidades. Para outras linguagens, adapte o código de acordo.
<?php
header('Content-Type: text/html; charset=utf-8');
# Parametros
$_TOKEN = 'xxxxxx';
$_CMD = 'send_file';
$_CT_WHATSAPP = '553196668586';
$_CT_CPF = '03104925640';
$_CT_IDEXTERNO = '1234';
$_FILE_URL = 'https://www.meusite.com.br/teste.pdf';
$_FILE_EXT = 'pdf';
# URL
$_URL = 'https://mbr.maxbot.com.br/api/v1.php';
# START
$_TXT = "[POST]:<br/><br/>";
$_TXT .= " API_URL => ".$_URL."<br/>";
$_TXT .= " token => ".$_TOKEN."<br/>";
$_TXT .= " cmd => ".$_CMD."<br/>";
$_TXT .= " ct_whatsapp => ".$_CT_WHATSAPP."<br/>";
$_TXT .= " ct_br_cpf => ".$_CT_CPF."<br/>";
$_TXT .= " ct_external_id => ".$_CT_IDEXTERNO."<br/>";
$_TXT .= " file_url => ".$_FILE_URL."<br/>";
$_TXT .= " file_extension => ".$_FILE_EXT."<br/>";
$_TXT .= "<br/>";
$_TXT .= "[retorno]:<br/><br/>";
$_TXT .= "<textarea rows=10 cols=90>";
echo $_TXT;
# Request API
$_REQUEST = array(
"token" => "$_TOKEN",
"cmd" => "$_CMD",
"ct_whatsapp" => "$_CT_WHATSAPP",
"ct_br_cpf" => "$_CT_CPF",
"ct_external_id" => "$_CT_IDEXTERNO",
"file_url" => "$_FILE_URL",
"file_extension" => "$_FILE_EXT"
);
$json = json_encode($_REQUEST);
$ch = curl_init($_URL);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $json);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
'Content-Type: application/json',
'Content-Length: ' . strlen($json))
);
$_result = curl_exec($ch);
curl_close($ch);
echo $_result;
echo "</textarea>";
exit;
?>
Utilize a requisição de disparo de áudio para enviar um arquivo de áudio MP3 para um contato existente no Maxbot. Você pode disparar áudios para qualquer contato previamente existente na sua base de contatos. O disparo é feito conforme as seguintes condições:
{
"token": "xxxx",
"cmd": "send_sound",
"ct_whatsapp": "553191112222",
"ct_external_id": "1234",
"ct_br_cpf": "11122233344",
"sound_url": "https://www.meusite.com.br/audio.mp3",
"sound_extension": "mp3"
}
{
"status": 1,
"msg": "Success"
}
Este exemplo funcional em PHP 7.3 executa um post para a API e apresenta o retorno na tela para validação. Modifique o código para se adequar às suas necessidades. Para outras linguagens, adapte o código de acordo.
<?php
header('Content-Type: text/html; charset=utf-8');
# Parametros
$_TOKEN = 'xxxxxx';
$_CMD = 'send_sound';
$_CT_WHATSAPP = '553196668586';
$_CT_CPF = '03104925640';
$_CT_IDEXTERNO = '1234';
$_SOUND_URL = 'https://www.meusite.com.br/audio.mp3';
$_SOUND_EXT = 'mp3';
# URL
$_URL = 'https://mbr.maxbot.com.br/api/v1.php';
# START
$_TXT = "[POST]:<br/><br/>";
$_TXT .= " API_URL => ".$_URL."<br/>";
$_TXT .= " token => ".$_TOKEN."<br/>";
$_TXT .= " cmd => ".$_CMD."<br/>";
$_TXT .= " ct_whatsapp => ".$_CT_WHATSAPP."<br/>";
$_TXT .= " ct_br_cpf => ".$_CT_CPF."<br/>";
$_TXT .= " ct_external_id => ".$_CT_IDEXTERNO."<br/>";
$_TXT .= " sound_url => ".$_SOUND_URL."<br/>";
$_TXT .= "sound_extension => ".$_SOUND_EXT."<br/>";
$_TXT .= "<br/>";
$_TXT .= "[retorno]:<br/><br/>";
$_TXT .= "<textarea rows=10 cols=90>";
echo $_TXT;
# Request API
$_REQUEST = array(
"token" => "$_TOKEN",
"cmd" => "$_CMD",
"ct_whatsapp" => "$_CT_WHATSAPP",
"ct_br_cpf" => "$_CT_CPF",
"ct_external_id" => "$_CT_IDEXTERNO",
"sound_url" => "$_SOUND_URL",
"sound_extension" => "$_SOUND_EXT"
);
$json = json_encode($_REQUEST);
$ch = curl_init($_URL);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $json);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
'Content-Type: application/json',
'Content-Length: ' . strlen($json))
);
$_result = curl_exec($ch);
curl_close($ch);
echo $_result;
echo "</textarea>";
exit;
?>